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What Is Included with This Guide? 


Introduction 


Introduction 


Introduction 


EEE ooo 


This Guide gives you the concepts and rationale behind the 
MS-DOS procedures. It presents the material in the natural 
sequence you follow when using MS-DOS. 


Introduction 


What Is MS-DOS? 


MS-DOS stands for Microsoft-Disk Operating System. An 
operating system is the traffic director of your computer. Like the 
signals at a busy intersection directing cars, the computer’s 
operating system is at the center of activity directing data. 
MS-DOS is an operating system designed to run your AT&T 
computer. It coordinates the flow of information between the 
screen, keyboard, memory, and storage disks. It also directs other 
devices attached to your computer, such as a printer or telephone 
coupler. 


You can make your computer perform certain tasks with a set of 
MS-DOS commands. This guide teaches both the fundamental 
MS-DOS commands and the more advanced commands that will 
extend your computing power. 
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What Is Covered In This Guide? 


Te 
The information in this guide is organized as follows: 


@ Chapter 1," Introduction," explains how to follow the 
examples in this Guide. It also contains a checklist of the 
diskettes containing MS-DOS and a list of the other manuals 
to help you use your computer. 


@ Chapters 2 and 3," Before You Start MS-DOS" and" Starting 
MS-DOS," introduce you to the basic concepts of MS-DOS 
and some of the important practices you should follow when 
working with a computer. You will learn about diskettes and 
files, and the vital importance of making duplicate copies of 
your important program and data diskettes. For users of a 
fixed disk drive system, Chapter 3 helps you get MS-DOS 
started on the fixed disk. 


@ Chapter 4," Using MS-DOS Commands," explains the 
concepts you've learned and puts them into practice. Contained 
here is a step-by-step introduction to the most commonly 
used MS-DOS commands, some information about automatic 
processing, and a recap of some useful practices. 


@ Chapters 5 and 6," MS-DOS Commands" and " Batch 
Processing Commands," are reference chapters. They contain 
alphabetic listings of each of the MS-DOS commands, their 
purpose, correct syntax, rules of usage, and examples that 
illustrate how each command is used. 


At the end of this Guide are Appendices which contain 
information about messages that appear on your screen, EDLIN, 
the line editor program on your MS-DOS System diskette. 
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How To Enter Keystrokes 
a ee es 


Later in this guide you will be provided with step-by-step 
procedures to follow. You are instructed to type certain words and 
characters and to press specific keys. It is important to type 
pao what is shown in the indented example (only the boldface 
part): 


A>type this 


The specific keys or sequence of keys which you should press 
appear in brackets like this: 


RETURN 


CTRL 
NUM LOCK 


In a sequence of two or more keys, as shown above, press and hold 
the first keys while you press the last key in the list. 


All other punctuation — commas, colons, slash marks, equal signs, 
spaces — must be entered exactly as shown. 
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What Is Included with This Guide? 


This MS-DOS Version 3.10 Release 1.0 User Guide comes with the 
following: 


@ MS-DOS System diskette 
This diskette contains MS-DOS and its related programs. 


@ MS-DOS Supplemental Programs diskette 
This diskette contains the LINK Utility, EXE2BIN, DEBUG, 
SHIP, BACKUP, and RESTORE. 


Both diskettes are in the plastic pocket at the back of this guide. 
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About Diskettes 


This chapter introduces you to some of the important concepts and 
practices you must know before you start using MS-DOS. If you 
are unfamiliar with using a computer and diskettes, the section of 
this chapter About Diskettes must be read carefully. If you 
have experience with computers, the practices in this section are 
second nature to you. New and experienced users alike should read 
the Files section, as the information here describes the file 
naming rules needed to use MS-DOS. 


The following sections cover the basic information you need to 
know about diskettes. If you are new to using computers, you 
should read these sections carefully. 


CARING Your diskettes are very valuable. They contain 

FOR information and data representing hundreds of 

DISKETTES hours of work. You must take care in their 
handling as well as follow prudent back up and 
archival practices. 
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Here are some rules and helpful hints to follow. 


@ Always keep the diskette in its envelope 
when it’s not in use. The envelopes are 
specially treated to resist static electricity 
and dust accumulation. 


| a 


@ Never touch the surface of the diskette. 
Handle the diskette by its protective cover. 


Bes 
O 
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@ Never bend or fold a diskette. 


© Store and use diskettes in a safe 
environment. Don’t let them get too cold or 
too hot. Keep them out of the sun or the 
trunks of automobiles. 
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Keep diskettes away from magnets or 
strong electrical fields. Keep diskettes 
away from your telephone. The 
information stored on the diskette can be 
damaged or erased. 


Always be very careful when inserting the 
diskette into a drive. Push gently. Never 
force a diskette into place. 
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@ Don’t write on a diskette with a ball-point 
pen or pencil. Use only a soft felt-tip 
marker. Better yet, prepare the diskette’s 
label first, then apply it to the diskette. 


o 
O 
0 


C [uso 
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Notice the small notch on a diskette below the 
label on the right. 


oc 
O 
0 


oc 
O 
0 


This is called the write-enable notch. If you 
cover the write-enable notch, information can 
only be read from the diskette. Data already 
on the diskette cannot be accidentally erased or 
written over by the computer. 
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You can cover the notch with a tab supplied 
with the diskette or with a piece of opaque 
tape. You can remove the tape when you want 
to add or erase information. 


It’s a good idea to protect your important 
diskettes this way. 


Many of the program diskettes you may buy 
have no notch. Such notchless diskettes are 
already “write protected.” The computer cannot 
write any information on to a write-protected 
diskette. 


WHY COPY 
YOUR 
MS-DOS 
DISKETTES? 


Before You Start MS-DOS 


Your MS-DOS System diskette holds all of the 
programs you need to make your computer 
operate. To protect it, make a “working” copy 
and save the original, or Master diskette, in a 
safe place. You should only use the Master 
diskette to make additional working copies. 


This is very important. 


Diskettes can be lost, physically damaged, and, 
on occasion, accidentally erased by sudden 
electrical surges in your computer or power 
systems. One of the first things you should do 
is make copies—duplicates—of your MS-DOS 
System diskettes. 


These copies become your day-to-day working 
copies of valuable master diskettes. 


Be sure to: 


@ Use a felt-tip marker to label and date 
each working copy diskette. 


@ Store the original or master diskettes in 
their paper envelopes in a safe place. 


@ Use the working copy diskettes in your 
daily work. 
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DISKETTES 
NEED TO BE 
FORMATTED 


Before you can use a brand new or blank 
diskette with MS-DOS, you must FORMAT the 
diskette. You need only do this once—before 
you use a diskette for the first time. 


FORMATing a diskette prepares it to receive 
and store data. Think of it this way. The 
FORMAT command is like putting lines on a 
newly paved parking lot so that cars can be 
parked in an orderly and efficient way. The 
FORMAT command writes “lines” (track and 
sector markers) on a new diskette. Data then 
is placed on the diskette in an orderly way and 
can be easily found and read. 
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What System Do You Have? 


Your computer system unit operates with either: 
®@ A single-diskette drive 
@ Two diskette drives 


@ A fixed (nonremovable) disk and a diskette drive. 


In this book, you learn how to use MS-DOS with these 
configurations. If you have a single-diskette drive system, a two- 
diskette drive system, or a fixed disk and a diskette drive, the 
information you need to know is in this chapter. 


In our examples, we use the following conventions to distinguish 
between the drives in a two-drive system. These are common 
synonyms, used by the comjuter industry and by users alike. 


Drive A Drive B 

(or diskette A) (or diskette B) 

is also called: is also called: 

Source & >Target 
Original <. >Backup 
Master < >New or Blank 
First <. >Second 
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IF YOU 
HAVE A 
SINGLE- 
DISKETTE 
DRIVE 
SYSTEM 


2-12 


If you have a single-diskette drive system, 
identify the drive as drive A. 


If MS-DOS tells you to insert a diskette into 
drive A and, later, to insert a diskette into 
drive B, put the first diskette into drive A. 
When MS-DOS tells you to insert a diskette 
into drive B, take out the previous diskette and 
put the second diskette into drive A. 


Before You Start MS-DOS 


IF YOU If you have two diskette drive system, identify 
HAVE A them as drive A (the bottom drive) and drive B 
TWO- (the top drive). 

DISKETTE 

DRIVE If MS-DOS tells you to insert a diskette into 
SYSTEM drive A and, later, a diskette into drive B, you 


can insert diskettes into both drives. You don’t 
have to exchange diskettes if you have two 
diskette drives. 
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IF YOU 
HAVEA 
FIXED DISK 
DRIVE AND 
A 
DISKETTE 
DRIVE 
SYSTEM 


A fixed disk is treated just like a diskette for 
most of the MS-DOS commands. Like a 
diskette, a fixed disk has a drive designation 
letter. You can read and write data from and 
to it. However, a fixed disk can hold millions 
of characters of information and can retrieve 
them much faster than from a diskette drive. 


Some MS-DOS commands are used only with a 
fixed disk drive. 


When you are copying the contents of a 
diskette to a fixed disk, the diskette drive is 
identified as drive A and the fixed disk is called 
drive C. 


More information about setting up a fixed disk 
drive is found at the end of this chapter. 


Fixed Disk 
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Files 


Information is stored in files on your diskettes or fixed disk. A 
computer file is like a file folder in a conventional filing cabinet. 
It contains related data on a specific subject. 


Every file has its own name called a “filename.” MS-DOS uses 
filenames to locate stored files. 


NAMING Each file on a diskette must have its own 

FILES unique filename. This way your computer can 
find the file you want. You can use the same 
filename on two different diskettes or a fixed 
disk, but this may lead to problems later when 
you are COPYing a file from one disk to 
another. 
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A filename is composed of: 
@ A name of one to eight characters 


@ A period, required as separator if an 
extension is used 


@ An extension of one to three characters 
(an extension is an optional identifier). 


Legal characters in a filename are: 
@ Letters of the alphabet 
@ Numbers 0 through 9 


@ These special characters: 


H&E @!%()- {7 YL 


All filenames appear in this format: 


name.extension 


Note: Spaces between characters are 
not allowed. 
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Examples of legal filenames are: 


DEBUG.COM START.BAS 
PHDTHSIS.78 MOM&SIS.LTR 
TAXES$.85 CH3PART1 
##4 MM 


Although the last filename on this list is 
legitimate, it doesn’t give you much 
information about the contents of the file. A 
good filename reminds you what information is 
in the file. 


To see what files are on a diskette, use the 
MS-DOS dir command. Files are displayed on 
the screen similarly to this: 


FC 
FDISK 
FIND 
FORMAT 


CHKDSK COM 4043 5-12-85 9:00 
33 File(s) 150528 bytes free 
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Note: On the line before the screen 
prompt, the number of files and free 
bytes will vary. 


Some of the names and numbers may be 
different, but the screen should show the same 
five columns and last line. 


This list of files will become very familiar. You 
see this list on your screen every time you 
enter a DIR command for an MS-DOS System 
diskette. 


The files on the MS-DOS System diskette are 
the programs that control your computer and 
perform important “housekeeping” tasks on 
your diskettes and files. Files on your diskettes 
contain many different types of information. 
There are simple text and data files—files that 
contain information that you create with a 
word processing or spreadsheet program. 
Other kinds of files are program files. These 
contain the instructions used by your computer 
to perform a task or complex operation. These 
are created using a programming language 
such as BASIC or Pascal—or other, specialized 
languages—and are meant to be used by a 
computer, rather than read by a person. 


The files on your MS-DOS System diskette are 
program files. 
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This chart describes the MS-DOS System 
diskette files and what they do. 


Contents of MS-DOS/GWBASIC System Disk 


Filename 
ANSLSYS 
ASSIGN.COM 
AUTOEXEC.BAT 
BASICA.COM 
BASIC.EXE 
CHKDSK.COM 
CHMOD.COM. 
COMMAND.COM 
COMP.COM 
DISKCOMP.COM 
DISKCOPY.COM 
EDLIN.COM 
FC.EXE 
FDISK.COM 
FIND.EXE 
FORMAT.COM 
GRAPHICS.COM 
GWBASIC.EXE 
JOIN.EXE 
LABEL.COM 
MODE.COM 
MORE.COM 
PRINT.COM 
RAMDISK.DEV 
RECOVER.COM 
SHARE.EXE 
SIZE.COM 
SORT.EXE 
SUBST.EXE 
SYS.COM 
TREE.COM 


Function of File 
Lets you use standard terminal escape sequences 
Routes request from one drive to another 

Contains commands executed at start-up 

Loads GWBASIC into memory 

Loads GWBASIC into memory 

Checks disks 

Changes and displays file and/or directory attributes 
Processes MS-DOS commands 

Compares files 

Compares diskettes 

Copies diskettes 

Line editor 

Compares files 

Partitions a hard disk 

Finds a string in a list of files or standard input 
Formats disks 

Sets up printer to print graphics 

GWBASIC interpreter 

Joins a disk drive to a specific pathname 

Creates, changes, or deletes a volume label on a diskette 
Sets display, communications, and serial printer environments 
Pages through text 

Prints spooler 

Sets up RAM for file I/O, resulting in faster access 
Recovers files on disk 

Shares files 

Lists filenames and file sizes of specified files 

Sorts text 

Creates a string alias 

Transfers MS-DOS System files from one disk to another 
Displays directories and files down the tree 
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—_————————_—_ 


Contents of Supplemental Disk 


Filename Function of File 

BACKUP.COM Backs up the fixed disk to diskettes 
DEBUG.COM Debugger 

EXE2BIN.EXE Converts .EXE files to .BIN files 


LINK.EXE Linker 
RESTORE.COM _ Restores files saved with BACKUP 
SHIP.EXE Prepares the fixed disk for shipping 


Even though the period is not displayed on the screen, you must 
use it when entering a file’s name and extension for separation 
when telling MS-DOS about that file. 


The IBMBIO.COM and IBMDOS.COM files reside on the MS- 
DOS/GWBASIC System Disk as hidden files. 
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RESERVED 
FILENAMES 
AND 
EXTENSIONS 


Filenames 


Extensions 


Some filenames have a special meaning in 
MS-DOS. Some filenames identify the 
hardware parts of your computer or its 
accessories. Some extensions identify types of 
files handled in a special way by your 
computer. 


Do not use the following reserved filenames 
when naming your own files. 


Filename Meaning 


AUX Refers to input or output to an 
auxiliary device—a printer or 
a modem. 

CON Refers to keyboard input or 


displayed output. 


NUL Used when you do not want to 
create a particular file, but 
requires an input or output 
filename. 


PRN Refers to the printer. 


The following chart shows some of the special 
extensions that you may use from time to time 
to identify program files that are used by a 
computer to perform some operation. 


Before You Start MS-DOS 


OO 


For example, if you write a batch processing 
program that performs a series of MS-DOS 
commands, you use the extension .BAT to tell 
MS-DOS how to handle the file whenever you 
want to run that program. 


Extension Meaning 


-BAS Basic file—A Basic program 
.BAT A batch program 

.COM A program 

-DAT Data file 

-EXE A program 


Note: You can add extensions of your 
own to the list. 
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WILD-CARD 
CHARACTERS 
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When you are using MS-DOS file commands, 
the wild-card characters * and ? can speed 

things up, particularly when you are working 
with multiple files. These characters provide 
flexibility in making choices about filenames. 


The ? character indicates that any valid 
character may occupy that position in a 
filename. For example: 


DIR INV???.85 


lists all directory entries that begin with INV, 
have any three following characters, and end 
with the extension 85. For example, these files 
might be found: 


INV.85 
INV003.85 
INVOIC.85 
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The * character in a filename indicates that 
any valid character can be in that position, all 
remaining positions, or in the extension. For 
example: 


DIR *.DAT 
lists all the files with the extension .DAT. 
These files might be found: 


85.DAT 
INVENTRY.DAT 
PAUL.DAT 
Q185.DAT 


The wild-card characters * and ? can be used 
together or interchangeably. They are powerful 
tools and should be used very carefully, 
particularly when using the DELete command. 
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FILE 
SPECIFI- 
CATIONS 
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When you want to call up a file, you must tell 
MS-DOS where to search for it—that is, you 
must specify what drive contains the diskette 
with that file. Type in: 


A>MOM&SIS.LTR 


Here, you provided only the filename. 
Therefore, MS-DOS searches the current 
Drive (A). 


These three parts—the drive letter, the name, 
and the extension—are called the pathname. 


Often, you need to fetch a file from a drive 
other than the current drive. In these cases, 
you need to specify the drive. For example, to 
specify a file on the B drive with a current A 
drive, type: 


A>type B:thisfile 


If your fixed disk (C) is the current drive, you 
may specify a file on drive A by typing: 


C>type A:thisfile 


The drive letter and the colon are called the 
drive specifier. Always type the colon (:) after 
the drive letter. Do not put any spaces between 
the three parts. 
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Loading MS-DOS 
an ee 


In this chapter you will learn about how to start your computer 
with MS-DOS and some of the basic techniques you will need to 
work with your operating system. Also, if you have a fixed disk 
drive in your computer, this chapter contains information about 
setting up MS-DOS on a fixed disk and some tips on using this 
type of disk drive. 


If MS-DOS is already installed on your fixed disk, some of the 
information in this chapter may be familiar to you. Review each 
section in this chapter to be sure that you understand how to begin 
using MS-DOS with your computer. 


There are two types of MS-DOS commands: internal and external. 
Internal commands are placed into memory whenever you start 
your computer with MS-DOS. Internal commands are the MS-DOS 
operations you use most often. For example, DIR is an internal 
command. External commands are the MS-DOS files on the 
System diskette placed in your computer’s memory when you 
specifically need them to do some task. For example, the 
FORMAT command is an external command. 


When you load or start MS-DOS, the MS-DOS internal commands 
are read from the COMMAND.COM file on the MS-DOS System 
diskette and placed into the computer’s memory. 


After this process is completed, the MS-DOS prompt A> or C> 
appears and you can enter a command. 


Starting MS-DOS 


This chapter contains keyboard pictures which highlight special 
keys. Since the AT&T PCs use two different keyboards, the top 
keyboard pictured represents the Model 301 keyboard with the 
following representing the Model 302 keyboard. 


rallfeon 


ENE 
(aa 


=) aos 


3-3 


Starting MS-DOS 


ees 


INSERTING To insert the diskette properly: 
DISKETTES 


1 Remove the diskette from its paper sleeve. 
2, Open the diskette drive door. 


3 Slide the diskette into drive A with the 
label side up. Do not force or bend the 
diskette. 


4 Shut the drive door carefully. 
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—- —_—_—_— xx 


If Your Computer Is OFF 


] Insert your working copy of the MS-DOS 
System diskette into drive A and shut the 
drive door. 


Q Turn on your computer. 


A few seconds elapse as the system checks 


itself. The more memory in your computer, the 
longer this checkout period lasts. The following 


messages appear on your screen. The exact 
wording or sequence may vary depending on 
your computer. 


Resident Diagnostics 
Vers X.XX 


cpu (i286) 
ROM Module 
DMA Timer 

DMA Control 


Interrupts 
640 kb RAM 
RT Clock 
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If Your Computer Is ON 


1 Press and hold the System Reset keys: 


a E ea |e] eae 


||| a a |e = 
carr 

jal SEE 
a a ce en a ial 


and then release them. 
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Resident Diagnostics 


Vers X.xx 


CPU (1286) 
ROM Module 
DMA Timer 
Dma Control 
Interrupts 
RT Clock 


Q Insert your working copy of the MS-DOS 
System diskette into drive A and shut the 
drive door. 


The diskette drive light comes on while MS- 
DOS is being read into memory. 
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When MS-DOS Is Ready: The Prompt 


After MS-DOS is loaded into memory, your screen looks like this: 


Resident Diagnostics 
Vers X.XX 


cpu (1286) Pass 
Rom Module Pass 
DMA Timer Pass 


DMA Control Pass 


Interrupts Pass 
S12 kb RAM Pass 
RT Clock Pass 


Fixed Disk 1 Ready 
Floppy (A:) Ready 


AT&T Personal Computer MS-DOS 3.10 Release 1.0 
Copyright (c) 1985 by ATET, all rights reserved 


Compatibility Software 
Copyright Cc) 1985 by Phoenix Software Associates Ltd. 


The A> on the screen is the MS-DOS prompt. Whenever this 
prompt appears, you know that MS-DOS is ready to go. A> 
prompts you, indicating that you must tell MS-DOS what to do 
next by entering a command. 
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Entering Commands 


— 


To make your computer perform a task, you must tell it what to 
do. This is called entering a command. The various MS-DOS 
commands perform different tasks such as displaying a list of files 
on a diskette (the DIR command), or making a duplicate of a 
diskette (the DISKCOPY command). 


Most MS-DOS commands do one thing. You tell your computer to 
do “this” or “that” with a single command. 


To give MS-DOS a command: 
1. Wait until the A> appears. 


Q Enter the command and any other information required. For 
example, it’s sometimes necessary to include a drive specifier 
or a file specification in a command. 


3 Press (RETURN and the command procedure begins. 


Entering an MS-DOS command is easy. Here are some simple 
rules: 


@ A command can be entered in uppercase or lowercase or any 
combination. 


@ Use a blank space to separate the parts of the command from 
one another. 


@ The MS-DOS command must be the first thing you type. 


@ Always press (RETURN) after typing the command. 
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If You Make A Mistake 


Sometimes you might make a mistake typing a command. You can 
correct an error two ways. You can press (BACKSPACE) which erases 
one character at a time as it moves to the left, then retype your 
input. You can also use the to move the cursor to the 
left and make the necessary change. 
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Stopping the Screen to Read It 


When the screen fills up with data, new information appears at 
the bottom, pushing what’s at the top “up” and causing it to 
disappear from view. This process is called scrolling. 


Some MS-DOS commands (e.g. DIR and TYPE) cause text to be 
displayed on the screen at such a rapid rate that data may be 
scrolled out of sight before you get a chance to read it. Use (rr)S 
to stop the display so that you can read what is on the screen. 


Qo 


Press any key to resume the display of text. 
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Printing What Is On The Screen 


You may want to have a printed copy of what is being displayed on 
the screen. For example, you may need a copy of a form or just 
one piece of information from a file. 


If you have a printer attached to your computer you can get an 
exact copy of what is displayed on the screen by pressing and 
holding (suiet) and then pressing (Pasd). 


If you are working with graphics, you must have loaded the 
GRAPHICS utility and must be using an AT&T 473 or compatible 
graphics printer. 


ey 
ERA 
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The Default Drive 
a ee a 


The “A” in the prompt indicates the default drive. The default 
drive is the diskette or fixed disk drive that MS-DOS uses to 
perform the command you've entered. When you enter a command 
or filename, MS-DOS automatically searches the diskette located 
in the default drive for this information, unless you indicate 
another drive in the file specification. For example: 


A>DIR 


searches drive A for a directory of files. Since no drive is 
specified, the default drive A is assumed. However: 


A>DIR B: 


searches drive B for a directory since drive B is specified. 


It is possible to change the default drive in the prompt. Enter the 
new drive designation letter and follow with a colon. For example: 


A>B: 


When you press after this command, the new prompt 
appears: 


B> 


To find a directory on a diskette in drive A, you would now have to 
enter: 


B>DIR A: 
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Using a Fixed Disk Drive 


If your computer is equipped with a fixed disk drive you must 
carefully consider how to best use your fixed disk before you 
prepare it to receive program and data files. 


If MS-DOS is the only operating system you are ever going to use, 
then the procedure is simple. Refer to the section in this chapter 
called Using MS-DOS Only for a step-by-step guide. 


If you are planning to use more than one operating system, or may 
choose to do so in the future, read through this entire section 
before starting to set up your fixed disk. If you are going to use 
more than one operating system you must allocate storage space 
on the fixed disk for each operating system. This is called 
“partitioning” the disk. Each operating system resides in its own 
partition. 


Fixed Disk 
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Some considerations: 


@ How many people will be using this computer? They may want 
to have their own subdirectory and may want to use another 
operating system. 


@ You can partition the fixed disk for other operating systems 
later. However, you must perform several steps to remove 
existing files onto other diskettes, then reformat and partition 
the fixed disk, before you can replace the existing files back 
into the MS-DOS partition. 


@ Despite the seemingly unlimited amount of storage available 
with a fixed disk partitioning the disk for two or more 
operating systems divides the available space. Be certain that 
having more than one operating system is what you want. 


@ To set up other operating systems on your fixed disk drive, 
refer to the appropriate documentation for the other systems. 
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If you are going to use MS-DOS exclusively 
with your fixed disk, follow these steps. 


1 Start the computer with your working copy 
of the MS-DOS System diskette in drive A. 


2 When the A> prompt appears, type: 


FDISK 


and press (RETURN). 


3 When the FDISK option menu appears 


choose #1 - Create MS-DOS Partition. 


4 When you are asked, Do you wish to use 


the entire hard disk for MS-DOS (Y/N)? 
Type: 


Y 


and press (RETURN). 


The entire fixed disk is now allocated for 
MS-DOS operations. 
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When the FDISK option menu reappears, 
the following prompt will appear at the 
bottom of the screen: 


Press ESC to return to DOS 


Press (Esc). 


The screen displays: 


System will now reboot 
Insert DOS diskette in drive A: 
Press any key when ready ... 


Insert your MS-DOS System diskette in 
drive A and press any key. 


The system restarts, and runs diagnostics. 
After a moment, the system displays the 
A> prompt. 
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To format the fixed disk, type: 


FORMAT C:/S 


and press (RETURN). 


This message is displayed: 


HE! WARNING ! 
You are formatting the hard disk 


THIS WILL DESTROY ALL DATA ON THE HARD DISK 


Enter Y to continue, any other key 
will cancel the request to format. 


Do you wish to format the hard disk? 


Type Y: 
The screen displays: 
WARNING, ALL DATA ON NON-REMOVABLE DISK 


DRIVE C: WILL BE LOST! 
Proceed with FormatCY/N)? 


Type Y to continue with the formatting 
process. 
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Note: Formatting a fixed disk 
takes several minutes. The screen 
displays the message “Formatting 
....’. When the process is finished, 
a message appears and the hidden 
system files are also placed on the 
fixed disk so you can start the 
computer from the fixed disk. 


10 Copy all of the external MS-DOS commands 
and related programs to the fixed disk by 
typing: 


COPY *.* C: 


and press (RETURN). 


Your fixed disk can now be used to start 
your computer. Whenever you turn your 
computer ON, or press the RESET button, 
or press and hold (att), (€rRt) and then 
press to restart the computer, leave 
drive A open and MS-DOS selects drive C 
as the default drive. 


Starting MS-DOS 


ll 


PARTITION- 
ING YOUR 
FIXED DISK 


If you are using more than one operating 
system with your fixed disk, you must partition 
the disk. This allows each operating system to 
occupy space tailored to its exact needs for 
proper operation. You may also want to 
partition a fixed disk if several people are using 
the same computer. A partition can be set up 
for each individual user or category of users. 


When you are using MS-DOS, you can have 
only one MS-DOS partition. 


Each operating system that can be used with a 
fixed disk has its own commands for placing it 
on the disk. Refer to that operating system’s 
user guide for instructions on placing it in its 
own partition on a fixed disk. 


The MS-DOS program that performs the 
partitioning of your fixed disk is FDISK.COM. 
It is on the MS-DOS System diskette. 
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The FDISK command allows you to: 


Set the size of the MS-DOS partition 
Set a partition’s position on the disk 


Select the active partition used when the 
computer is started 


Delete the MS-DOS partition 
Display the partition map. 


Perform the above operations on either of 
two fixed disks, if you have added an extra 
fixed disk. 


3-21 


Starting MS-DOS 


CREATING 1. Type: 

THE 

MS-DOS 

PARTITION EDISE. 


and press (RETURN). 


In a few seconds, the FDISK menu appears 
on the screen. 


FDISK Options 


Choose one of the following: 


: Create DOS Partition 
: Change Active Partition 
: Delete DOS Partition 


: Display Partition Data 


Enter choice: 


Press Esc to return to DOS. 
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If you have more than one fixed disk, the 
screen displays an extra option: 


Select next fixed Disk Drive. 


Choose #1 Create MS-DOS Partition from 
the FDISK menu. 


If the disk has not been already set up you 
are asked if you want to use the entire 
fixed disk for MS-DOS. Type: 


N 


and press (RETURN). This causes a message 
describing the total number of cylinders 
your fixed disk has and the size and 
location of the contiguous cylinders. If 
there is nothing on the disk, these two 
amounts are the same. 
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4 Ifyour fixed disk is already set up this is a 
typical display: 


Create DOS partition 


Partition Status Type Start End Size 
1 A Dos 0 610 611 


Total disk space ts 611 cylinders 


The current active partition is 1 


Fixed disk already has a DOS partition. 


Press Esc to return to FDISK Options 
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If you have more than one fixed disk, the 
screen displays information for each disk. 


This shows a typical partition map with 
three partitions on the fixed disk. This 
information describes: 


@ the partition status, Active or Non- 
active 


@ MS-DOS or non-MS-DOS contents 


@ the beginning and ending cylinder 
number of the partition 


@ the size of the partition 

@ total space on the fixed disk 
@ available space and location 
Respond to the prompt: 

Enter partition size ...... 


by typing the number of cylinders you want 
to allocate for MS-DOS. Enter the number 
and press (RETURN). 
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6 Respond to the prompt: 


Enter starting cylinder number ... nnn 


by either pressing or entering 
another 3-digit number. The default value 
displayed is the first cylinder of the 
smallest space that is large enough for the 
partition size you entered for Step 5. 


Respond to the prompt: 


Press (Esc) to return to the FDISK 
Option 


You may want to check that the MS-DOS 
partition is active by going to the partition 
map display. 


You should now restart your system by 
choosing the Return to DOS option. Be 
sure to have the MS-DOS System diskette 
in drive A. 
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Run FORMAT to format the MS-DOS 
partition on the fixed disk. Type: 


FORMAT C:/S 
When the format is complete, type: 
COPY *.* C: 


Steps 9 and 10 format the MS-DOS 
partition, move the hidden system files into 
the partition, then copy the MS-DOS 
external commands from the system disk. 


Remove MS-DOS System diskette from 
drive A. 


Insert Supplemental diskette in drive A and 
type: 


COPY *.* C: 


Your fixed disk is now ready to be used. 
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CHANGING Enter the FDISK command and select #2 

THE Change Active Partition from the menu. If you 

ACTIVE have more than two operating systems 

PARTITION installed, be sure you know which one you want 
to make active. 


Simply respond to the prompt: 


Enter the number of the partition you want 
to make active 


by typing the number of the partition you want 
to be the partition that starts your computer, 
and pressing (ReTURN). The displayed partition 
map is updated and the new partition is used 
as the startup file for your computer. 
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Be careful. Deleting this partition destroys the 
contents of this part of the fixed disk. Be sure 
to make backup copies of the files. Use the 
MS-DOS command BACKUP before you 
continue. 


To delete the MS-DOS partition, select #3 
Delete MS-DOS partition from the FDISK 
menu. The partition map is displayed along 
with a “Warning” advisory. 


To cancel the delete operation press (Esc). 


To proceed with the delete operation press Y 


and (RETURN). 


To restart your computer with MS-DOS after 
you have deleted the MS-DOS partition you 
must use an MS-DOS System diskette in 
drive A. 


To restart your computer with another 
operating system you must either: 


]_ Select another active partition. 


2 Use another MS-DOS System diskette in 
drive A. 
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DISPLAYING Option #4 Display Partition Data from the 
THE FDISK Option menu causes the partition map 
ioe to appear on the screen typically like this: 


Display Partition Information 


Partition Status Type Start End Size 
1 a Dos o 610 «611 


Total disk space is 611 cylinders 


The current active partition is 1 


Press Esc to return to FDISK Options 


To return to the menu, press (& 


Note: Option #5, Select Other Disk, 
will only appear if a second hard disk 
unit is installed. 
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ORGANIZING 
YOUR 
FIXED DISK 


The information contained in this section is 
“helpful hints” about using a fixed disk drive. 
For new computer users, or users who haven’t 
used fixed disks before, putting all available 
disk storage to best use can pose a challenge. 


To help you, MS-DOS has the capability to 
create subdirectories and sub-subdirectories. 
Imagine an upside down maple tree. (The 
trunk is in the air and the main branches and 
limbs are balancing all of this lightly on the 
ground.) 


When you issue the MS-DOS DIR command, a 
complete listing of all the files on the specified 
drive appears on the screen. What is displayed 
are all of the files on that disk or diskette. If 
you’ve been using your fixed disk for storage 
for all of your work and program files, this can 
be a very, very long listing. 


The DIR command is showing you everything 
in the “trunk” or ROOT directory of the tree. 
You can have several hundred files on the 

disk — and this is not too difficult to do — it is 
both time consuming and tedious to locate a 
specific file if you’ve forgotten its exact name 
and extension. 


What's more, if there are a large number of 
files in the directory, system performance slows 
down when your computer is looking for a 
specific file. 
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A SAMPLE 
MULTI- 
LEVEL 
DIRECTORY 


To solve these problems, you create 
subdirectories — branches and limbs of the 
main tree. By establishing a path the DIR 
command can follow, you speed up processing. 
With faster processing you get your own work 
done more quickly. 


The following illustration shows how a fixed 
disk subdirectory structure might be set up. 


Bill sets up his computer so that Mike and 
Sue, who work for Bill have their own 
subdirectories. Mike is a financial analyst and 
frequently uses a spreadsheet program. Sue is 
a product manager involved in developing and 
testing new products. 
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Here is how Bill sets up his disk directories. 


Volume in 


Directory 


COMMAND 
AUTOEXEC 
CHKDSK 
comp 
DISKCOPY 
FC 

FDISK 
FORMAT 
GWBASIC 


BILL 
SPREAD 
uP 
TEST 


drive C has no label 


of c:\ 
com 15957 
BAT 1 
com 6468 
com 2766 
com 2051 
EXE 2585 
cOM 4464 
com s872 
EXE 69008 
<DIR> 
<DIR> 
<DIR> 
<DIR> 


5-01-85 
5-25-85 
5-01-85 
5-01-85 
5-01-85 
5-01-85 
5-01-85 
5-01-85 
S-01-85 


7-01-85 
7-01-85 
7-02-85 
7-03-85 


2 Oo 


Ola 
:08p 


00a 
00a 


:00a 
100 
:00a 
:00a 
:01a 


1308 
:15p 
45a 
:30p 


In the main (ROOT) directory, Bill has placed 
all of the MS-DOS operating system and 
related programs. Thus, all of the MS-DOS 
functions are available to whoever is using the 
computer. 


Starting MS-DOS 


Sse 


There are four subdirectories. 
© A private directory for Bill 


© The Spreadsheet directory that contains 
the spreadsheet program and two sub- 
subdirectories 


@ The Word Processing directory that 
contains the word processing program and 
two sub-subdirectories 


@ The Test subdirectory and two sub- 
subdirectories that contain files about the 
new products that Bill and Sue review. 


Bill mapped out the fixed disk directories 
before he assigned them names. Then he used 
the MD (Make Directory) and CD (Change 
Directory) commands to create this structure. 
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Here’s how he did it: 

1. Loaded MS-DOS into memory. 

2 Created his personal directory by typing: 
MD BILL 


This created the subdirectory BILL under 
the ROOT directory. Bill keeps his own 
programs and special files here. 


After he starts his computer, and the 
MS-DOS prompt appears, he types: 


CD \BILL 


to get into his own directory. 
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8 To create the SPREAD subdirectory for the 
spreadsheet program and its subdirectories 
Bill typed: 


MD C:\\SPREAD 


First, he created the subdirectory SPREAD 
under the ROOT directory. Then he 
changed directory (CD) to SPREAD by 
typing: 


CD SPREAD 


Next, Bill typed: 
MD BILL 
and 
MD MIKE 


to create a subdirectory for himself and for 
Mike. The MD command can also be 
entered as MKDIR. 
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4 Bill repeated this process for the word 
processing directory (WP) with the 
commands: 


CD \ (return to ROOT directory) 
Then he typed: 
MD C:\\WP 


to Make a Directory on drive C: named 
“WP”. He then used the Change Directory 
command to enter the new WP directory by 
typing: 


CD WP 


and created two subdirectories for his 
people who would be using the word 
processing directory, WP by typing in the 
commands: 


MD BILL 
and 


MD SUE 
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5 To complete the directory-building process 
Bill typed in the following commands to 
create subdirectories under the directory 
named TEST: 


CD \ 
MD C\ TEST 
CD TEST 
MD BILL 
MD SUE 
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Whenever Sue wanted to get into the files she 
was keeping on the new products undergoing 
testing, she started the computer and issued 
the following commands: 


CD \TEST\SUE 


which identifies the path to her personal 
subdirectory under the TEST directory, and 


DIR 


which displayed a directory listing of all her 
files under that subdirectory so that she could 
select the file she wanted to work with. 


By dividing up each user’s files into 
subdirectories Bill provided an easy way for 
each computer user to access their own files out 
of the 200-odd files that were stored on the 
fixed disk. In this way, operation of the 
computer’s file storage disk was speeded up, 
and making backup copies of each person’s 
work files was made a good deal easier. 


Using MS-DOS 
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MS-DOS Commands for Common Tasks 
a ee 


In this chapter, you will learn about the most frequently used 
MS-DOS commands, what you need to carry out each of them, and 
how to proceed step-by-step. These MS-DOS commands are the 
commands that you are going to use so often that they become 
“second-nature”. 


What you learn in this chapter will help you on your own to learn 
to use all MS-DOS commands. 


In the process of starting MS-DOS, some commands are loaded 
into memory where they stay until you need them. These are the 
internal commands. You don’t need a copy of the MS-DOS System 
diskette in a drive in order to use one of them. The common 
internal commands and their functions are: 


Command Function 


COPY Copying a file 

DIR Finding out what files are on a 
diskette 

TYPE Looking at a file’s content 


RENAME Changing a file’s name 


DEL Removing a file 
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With the exception of fixed disk systems, most MS-DOS commands 
require that you have a copy of the MS-DOS System diskette in a 
drive. These are called external commands. The most common 
external commands and their functions are: 

Command: Function: 


FORMAT Getting a diskette or fixed 
disk ready for use 


DISKCOPY Copying a diskette 
DISKCOMP Comparing diskettes 


COMP Comparing files 
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Formatting a Diskette 
a ee ee 


The FORMAT command prepares a diskette to receive information. 
You only need to FORMAT a diskette once, when it is new. 
FORMAT sets up the “tracks” and “sectors” where data is written 
on the diskette or fixed disk by your computer. FORMAT also 
checks the diskette or fixed disk to make sure it has no flaws, then 
creates a directory to find the data you eventually write on it. 


Be careful. FORMAT removes all of the information on a diskette 
or fixed disk. Be sure the diskette you are going to FORMAT does 
not contain information you want to keep. 


WHAT IS © the MS-DOS System diskette 
NEEDED 


@ the diskette you want to format 


PROCEDURE If you have a single diskette drive, MS-DOS 
instructs you to switch diskettes. Do not 
remove or replace a diskette until you are told 
to do so. 


1 Load MS-DOS and wait until A> appears. 


2 Leave the MS-DOS System diskette in 
drive A. 
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3. Type: 


A>format a: 


and press (RETURN). The drive in your AT&T 
PC is dual-sided and this creates a diskette 
for dual-sided use only. 


This message appears on the screen: 


Insert new diskette for drive B: 
and strike any key when ready 


4 FOR TWO DRIVES: Insert the new diskette 
into drive B and press any key. 


WITH ONE DRIVE: When the drive A 
light goes off, remove the MS-DOS System 
diskette from drive A, insert the new 
diskette into drive A, and press any key. 
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While the diskette is being formatted, 
Formatting ... 


appears on the screen. After the procedure 
is finished, typically you see: 


Formatting ... Format complete 


362496 bytes total disk space 
362496 bytes available on disk 


Format another (Y/N)? 


Note: The message on your screen 
may also show some number of 
bytes in bad sectors. If the screen 
message shows bad sectors, try 
formatting again. Discard the 
diskette if there are still more than 
3000 bytes in bad sectors. 
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If you have more diskettes to format, type 
Y for yes and repeat the above steps. 


To stop formatting, type N for no. The 
MS-DOS prompt appears and you can 
remove the newly formatted diskette. 


If you include /S after the command 
FORMAT, MS-DOS copies the system files 
to the target diskette as well as formatting 
the diskette. This type of FORMAT 
command is entered as: 


A>format b:/s 


The result is a diskette that starts MS-DOS 
directly. If you add system files to a 
formatted diskette a typical screen shows: 


362496 bytes total disk space 
43008 bytes used by system 
319488 bytes available on disk 
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Finding Out What Files Are Ona 
Diskette 


The DIR command displays the names and file statistics of the 
files on a diskette. When you are looking for a specific file and 
you don’t know on which of your diskettes it found, the internal 
DIR command helps you find what you are looking for. 


WHAT IS @ the diskette whose file directory you want 
NEEDED to check 


If MS-DOS is already in memory, you don’t 
need the MS-DOS System diskette for this 
procedure. 


PROCEDURE 1 Make sure MS-DOS is ready and A> is 
displayed. 


2 Insert the diskette you want to check into 
drive A. 
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3 Type the command: 


Aodir 


and press (RETURN). 


The following is displayed on the screen: 


The volume label of the diskette (if it 
has one) 


The name of the directory that is being 
listed 


The directory’s files — one line is 
displayed for each file with this 
information: 


— filename 

— extension 

— size (in bytes) 

— date and time that information was 
last written in the file 


The amount of free space left on the 
diskette (in bytes) 
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5 When all the files have been displayed, A> 
appears. 


Note: If the screen is scrolling too 
fast for you to read the files, use 
(GiRvS to stop it. 


To print what appears on the 
screen, use the and (Pas) 
keys. 


If you type A> DIR /P and press (RETURN), the 
directory display halts as soon as the screen is 
full (/P means Page). Press any key to resume 
the listing. 


If you type A> DIR /W and press (RETURN), 
only the filenames are displayed, five to a line 
across the screen (W means Wide). This lets 
you look at a large directory at a glance. 
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Copying a Diskette 


ALWAYS make duplicates of your important diskettes. 


WHY YOU This is a rule that every computer user learns 
SHOULD the hard way. To prevent the bother of having 
ALWAYS to re-do hours of work or replace vital 

MAKE programs, make copies of your files and put 
COPIES OF them away for a rainy day. 

DISKETTES 

HOW TO The DISKCOPY command makes a duplicate of 
COPY an entire diskette on another diskette. As you 


DISKETTES learned in Chapter 1, it’s a good idea to make 
working copies of your program diskettes as 
soon as you get them. Use the copies for daily 
work. 


Note: The date and time shown with a 
directory entry are the date and time of 
the last addition or change to that file. 
The date and time are not changed 
when you use the DISKCOPY 
command. 


Use the internal command COPY to 
move files between a fixed disk and a 
diskette, or to copy only specific files 
from one diskette to another. 
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WHAT IS @ the MS-DOS System diskette 
NEEDED 


© the original — or source — diskette 


@ the blank — or target — diskette that’s 
going to become the copy. 


Note: If the target diskette you 
use has files on it, all of these old 
files are wiped out during the 
procedure. That’s because 
DISKCOPY makes an exact 
duplicate of the original diskette 
onto the target diskette. 


DISKCOPY will also format the target 
diskette if it has not already been 
formatted. 


4-12 


Using MS-DOS Commands 


PROCEDURE If you have one diskette drive, MS-DOS treats 
it as both drive A and B. Switch diskettes each 
time MS-DOS tells you to exchange diskettes. 


1 
2 


3 


Load MS-DOS and wait for A> to appear. 


Insert the MS-DOS System diskette into 
drive A. 


Type: 


A>diskcopy a: b: 


and press (RETURN). 


WITH TWO DRIVES: This message 
appears: 


Insert source diskette in drive A: 
Insert target diskette in drive B: 
Strike any key when ready 


Remove the MS-DOS System diskette, 
insert the source diskette into drive A and 
the target diskette into drive B. Press any 
key when ready. 
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If the target diskette is not formatted, or is 
formatted differently from the source 
diskette, DISKCOPY will display: 


Formatting while copying 


It will also format the target diskette as 
well as copy the files to it, such that it is 
an exact copy of the source diskette. 


WITH ONE DRIVE: This message appears: 


Insert source diskette in drive A: 
Strike any key when ready 


Remove the MS-DOS System diskette that 
is in drive A. Insert your source diskette 
into drive A and press any key. 
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4 WITH TWO DRIVES: You'll notice that 
the lights on drives A and B go on and off 
as the copying proceeds. Do not open either 
drive door at any time during the process. 
DISKCOPY is complete when the following 
appears: 


Copying complete 


Copy another (Y/N)? 


WITH ONE DRIVE: The in-use light 
comes on while the source diskette is being 
read. When the computer has read the 
entire source diskette (or as much of it as 
can fit in memory), this is displayed: 


Insert target diskette in drive A 
Strike any key when ready 
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Remove the source diskette, insert the 
target diskette, and press any key. The 
light is on while the copy is being written. 
Depending on the amount of memory in 
your computer, the message displayed 
above may reappear. You may be required 
to repeat this diskette exchange process 
several times until you see: 


Copying complete 


Copy another CY/N)? 


5 If you have more diskettes to copy, type Y 
for yes and follow the steps again. 


If you are finished, type N for no. 
When the A> appears, remove the target 
diskette, prepare an appropriate label, 


apply the label to the diskette and store it 
in its paper sleeve. 
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Comparing Diskettes 


The DISKCOMP command makes sure that the duplicate diskette 
you’ve just made was copied accurately. In most cases the 
DISKCOPY command discovers any problems while it is 
performing the copy, but sometimes there is no warning that 
something has not worked out just right. 


The DISKCOMP command compares the source and destination 
disks to make sure they are exact duplicates. It is a good idea, 
particularly with important data files or valuable programs, to 
double check by using the DISKCOMP command. 


WHAT IS @ The MS-DOS System diskette 
NEEDED 


@ The original diskette 
@ The new duplicate diskette 


PROCEDURE If you have one drive, MS-DOS treats it as both 
drive A and B. Switch diskettes each time 
MS-DOS tells you to exchange diskettes. 


For this procedure, the source or original 


diskette is the first diskette, and the 
destination or duplicate is the second diskette. 


J Load MS-DOS and wait for A> to appear. 


2, Insert the MS-DOS System diskette into 
drive A. 


4-17 


Using MS-DOS Commands 


———- i i 


4-18 


3 Type: 


A>diskcomp a: b: 
and press (RETURN). 


WITH TWO DRIVES: This message 
appears: 


Insert first diskette in drive A: 
Insert second diskette in drive B: 
Strike any key when ready 


Insert the first diskette into drive A, the 
second diskette into drive B, and press any 
key. 


WITH ONE DRIVE: This message appears: 


Insert first diskette in drive A: 
Strike any key when ready 


Remove the MS-DOS System diskette from 
drive A, insert the source (original) diskette 
into drive A, and press any key. 
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5 WITH TWO DRIVES: The drive lights go 
on and off as the computer compares the 
two diskettes. Do not open the drive doors 
during this process. When the process is 
complete, the screen looks like this: 


Ardiskcomp a: b: 

Insert first diskette in drive A: 
Insert second diskette in drive B: 
Strike any key when ready 


Comparing 9 sectors per track, 2 sides 


Diskettes comparing ok 


Compare more diskettes (Y/N)? 


WITH ONE DRIVE: The drive light comes 
on while the source diskette is being read, 
and then this message is displayed: 


Insert second diskette in drive A: 
Strike any key when ready 


Remove the source diskette from drive A, 
insert the target (duplicate) diskette into 
drive A, and press any key. 
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The light comes on once again while the 
duplicate diskette is being compared. 


Depending on the amount of memory in 
your computer, you may have to switch the 
diskettes several times until this message 
appears: 


Diskettes compare ok 


Compare more diskettes (Y/N)? 


6 If you have more diskettes to compare, type 
Y for yes and repeat the procedure. 


If you don’t want to compare any more 
diskettes, type N for no. 


You don’t have to press (RETURN). After the 
MS-DOS prompt appears you can remove 
the diskette(s) from the drive(s). 


If the diskettes are not identical, go 
through the copying and comparing 
procedures again. If the diskettes do not 
compare successfully, use another target 
diskette. The first target diskette is 
probably bad and should be re-formatted. 
Format the troublesome diskette, then 
repeat the copy and compare procedures 
once again. 


If this last attempt does not solve the 
problem, discard the bad diskette and use 
another one. 
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Copying a File 


Use the COPY command when you want to copy only a few files instea 
of an entire diskette, or when you are copying to or from a fixed disk. 


Sometimes copying a single file to a target disk is a good way of 
archiving your work. You might want to keep all of your copies of 
specific types of files on a special archive diskette. All the 
company memos are copied to the “Company Memos” diskette, 
your travel expense records are copied to the “T&E” diskette, etc. 
In another case, database files on a fixed disk should be copied 
onto archival diskettes after every update of the information in the 
entire file. The internal COPY command is the one to use. 


Note: The date and time shown with each directory entry 
are not changed during a COPY. 


WHAT IS @ MS-DOS loaded into your computer’s 
NEEDED memory 


@ A formatted diskette that contains the file 
you want to copy (source diskette) 


@ The diskette that is to receive the copy of 
the file (target diskette) 
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Be careful. If files already exist on the target 
diskette, COPY does not disturb these old files 
as long as their names aren’t the same as files 
being copied. If you do copy a new file onto a 
diskette with an old file of the same name, the 
old file will be replaced. 


If you COPY onto a diskette with other files, 
make sure in advance there is enough space (in 
bytes) left to hold the new file(s). 


Note: The COPY command also lets 
you merge two or more files into a 
single target file. Refer to Chapter 5 
for more information about merging 
files with the COPY command. 


Use the COPY command with two wild 
cards (COPY A:*.* B:) to move all the 
files from a well-used diskette to a 
fresh one. COPY places each file on the 
target diskette one after the other. The 
source diskette can then be erased to 
recover space on the diskette to receive 
new files. 
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If you have one diskette drive, MS-DOS treats 
it as both drive A and drive B. Switch 
diskettes each time MS-DOS tells you to 
exchange diskettes. 


]_ Load MS-DOS and wait for the A> to 
appear. 


2, Remove the MS-DOS System diskette and 
insert the source diskette into drive A. 


3 WITH TWO DRIVES: Insert the target 
diskette into drive B. Type: 


A>copy filename b:newname 


and press (RETURN). 


Note: The filename of the copy can 
be either the same as the original 
or given a new name. 


Make sure you put in spaces where 
indicated in the command. 


Wait until the screen message: 
1 file(s) copied 


appears. 
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4 WITH ONE DRIVE: Enter the command: 
A>copy filename b:newname 


and press (RETURN). 


This message appears: 


Insert diskette for drive B: 
and strike any key when ready 


Remove the source diskette from the drive, 
insert a formatted target diskette, and 
press any key. 


Depending on the size of your computer’s 
memory you may have to switch the 


diskettes several times to complete the 
procedure. 


5 When the copy has been made, the 
following appears: 


1 FileCs) copied 


A> 


Remove the target diskette from the drive, 
label it with a felt-tip pen, and store both 
diskettes in paper sleeves in a safe place. 
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Comparing Files 


The COMP command lets you know whether the file or group of 
files you just copied using the COPY command is identical to the 
source file(s). 


Note: COMP cannot be used to check files you have stored 
on the diskette using the BACKUP command. 


It is a good idea to check to make sure your archival copy of a file 
is the same as the original, particularly if the information in that 
file is important. Sometimes the diskette that you are copying 
files onto may have, or may have developed, a flaw since the last 
time you used it. The external COMP command checks to make 
sure your COPY command was successful. 


COMP differs from DISKCOMP in that COMP works on individual 
files rather than complete diskettes. COMP is faster than 
DISKCOMP. 


WHAT IS @ The MS-DOS System diskette 
NEEDED 


@ The diskette containing the original file 
(the source) 


@ The diskette containing the copied file (the 
target) 
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If you have one diskette drive, MS-DOS treats 
it as both drive A and B. Switch diskettes each 
time MS-DOS tells you to exchange diskettes. 


1 Load MS-DOS and wait for A> to appear. 


2 Insert the MS-DOS System diskette into 
drive A if it isn’t there already. 


3 Type: 
A>comp 


and press (RETURN). 


When you get the message: 


Insert diskette for drive A: 
and strike any key when ready 


insert the diskette to be compared and 
press any key. 
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When this message appears: 
Enter primary file specification 


enter the filename from the source diskette. 
like this: 


A>Da:filename 


and press (RETURN). 


The next message to appear is: 
Enter secondary file specification 


Enter the name of the file you copied to the 
target diskette: 


A>b: filename 


WITH TWO DRIVES: Insert the target 
diskette into drive B (the original should 
already be in drive A) and press (RETURN). 
The names of the files being compared are 
displayed. 
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WITH ONE DRIVE: With the source 
diskette in drive A, press (RETURN). Shortly, 
this message appears: 


Insert diskette for drive B: 
and strike any key when ready 


Remove the source diskette from drive A, 
insert the target diskette into drive B, and 
press any key. 


If the size of the files being compared is 
very large, you may have to switch 
diskettes several times and repeat steps 3 
and 6. The files are placed in memory and 
some files may be larger than the portion 
of memory allocated during the compare 
process. 


When the files have been compared and 
found to be identical, this message appears: 


Files compare ok 


Compare more files C€Y/N)? 


If you have more files to compare, type Y 
for yes and repeat the procedure. 


If you are finished, type N for no. 


The MS-DOS prompt is displayed and you 
can go on with the next operation. 


Using MS-DOS Commands 


If the files are not identical, a number of 
advisory messages appear on the screen, 
and the COMP program stops. Go through 
the copying and comparing steps again. 
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Looking at a File 


—!_| 


The TYPE command lets you display the contents of a file on your 
screen. 


You may want to do this when you are uncertain about which file 
you want to do some work on. The internal TYPE command lets 
you quickly review the text of a file to check if it is the one you 
want. This way, you don’t have to start another program (for 
example, a word processor) in order to check the contents of a file. 


If you use the TYPE command with a program file the results 
displayed on your screen may not be understandable. Because 
program files contain control characters or are in a format best 
used by a computer rather than read by a person, the contents of 
these files often are best examined by using the programming 
language with which they were created. 


Experimenting with program files and the TYPE command does 
not harm the program file, but you may need to RESET your 
computer to continue. 


WHAT IS @ The diskette with the file you want to 
NEEDED display 


If MS-DOS is already loaded into your 
computer’s memory, you don’t need your 
MS- DOS System diskette for this procedure. 
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Make sure MS-DOS is ready and wait for 
A> to appear. 


Insert the diskette into drive A. 


Enter the name of your file with the 
command: 


A>type filename 


Press (RETURN). 


The command just entered and the file 
contents are now displayed. 


Use (GrrS To stop the scrolling. Press any 
key to resume scrolling. 


When A> reappears, you can remove the 
diskette. 
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Changing a Filename 
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The RENAME command lets you change a filename — its name, 
extension, or both. 


You may want to change a filename to more closely identify the 
contents of a file that started out to be one thing, but ended up 
another. Other times, the RENAME command can be used to 
identify groups of files with common attributes. 


Another way of renaming a file is to use the COPY command. The 
command syntax is the same as RENAME, the difference being 
that you then have two copies of a file, one with the original name 
on one diskette, and another with the new name on another (or the 
same) diskette or fixed disk drive. 


WHAT IS @ The diskette with the file you want to 
NEEDED rename 


If MS-DOS is already loaded, you don’t need 
the MS-DOS System diskette for this 
procedure. 


PROCEDURE 1] Make sure MS-DOS is ready and the A> 
appears. 


2, Insert the diskette into drive A, if it’s not 
already there. 
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3 Enter the command, plus the name of the 
old and new filename: 


A>rename oldfile newfile 


Press (RETURN). 


Note: The current filename is 
first, followed by a space, and then 
the new filename. 


4 Once the operation is finished, the MS-DOS 
prompt reappears. Remove the diskette 
from the drive and replace it in the paper 
sleeve. 
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Removing a File from a Diskette 


eee 


Be careful with this command. Once a file has been DELeted 
(ERASEq), it is gone forever from that diskette or fixed disk drive. 
Make sure that DELeting a file is what you want to do. 


Be very careful about using the DELete or ERASE commands 
when using wild card characters. 


It is a good idea to “clean up” your diskettes from time to time. 
Remove obsolete or duplicate files to make more room for new 
files. Also, if a diskette has had a lot of activity — files added and 
removed — the amount of space on the diskette may be broken 
into a number of ‘empty’ spots too small to receive new files. See 
the COPY command for a tip on recovering small spaces on a 
diskette. 


Note: Use this command with great care. Always double 
check your typed entries before pressing (ReTuRN). Once 
erased, a file cannot be retrieved. 
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WHAT IS @ the diskette with the file you want to erase 
NEEDED 


If MS-DOS is already in your computer’s 


memory, you don’t need the MS-DOS System 
diskette for this procedure. 


PROCEDURE ] Make sure MS-DOS is ready and the A> 
prompt appears on the screen. 


2 Insert the diskette with the file you plan to 
erase into drive A. 


3 Enter the command, plus the name of the 
file to be deleted: 


A>erase filename 


Check your typed entry. 


Press 


4 Shortly, the A> reappears. Remove the 
diskette from the drive, relabel it, and 
return it to its paper sleeve. 
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Processing a Series of Commands 
Automatically 
a ee 


MS-DOS allows you to create a file containing a series of MS-DOS 
commands that are immediately performed, one after another. 
This is called batch processing and the files used are called batch 
files. 


You could use a batch file to start other programs on a diskette or 
to perform some routine startup tasks that you usually do 
whenever you turn on your computer. If you want your computer 
to do some regular task each time you turn it ON or whenever you 
restart it with the (att), (Err), and (DE) keys, you create a file 
called AUTOEXEC.BAT. 


THE Whenever you power ON or restart your 
AUTOEXEC.BAT computer, MS-DOS looks on the startup drive 
FILE for a file named AUTOEXEC.BAT. This file 


must be on the default drive. If you are using 
a two-diskette system, the file must be in 
drive A. 


If you have a computer with a fixed disk drive, 
MS-DOS looks on the fixed disk for 
AUTOEXEC.BAT. When found, MS-DOS 
automatically performs each of the commands 
in the file. 
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For example, you can redirect information 
being sent to the default printer port (LPT1:) 
over to a serial communications port (COM1:), 
then run a GWBASIC program called 
INVOICING with the following 
AUTOEXEC.BAT file: 


MODE COM1:12,N,8,1,P 
MODE LPT1:=COM1 
GWBASIC INVOICING.BAS 


The first line invokes the MS-DOS MODE 
command and defines the setup parameters for 
the serial printer attached to the serial port 


CcOM1. 


The second line uses the MODE command to 
redirect output from the parallel printer port 
LPT1 to COM1. 


The third line loads GWBASIC from the 
default diskette then loads the program called 
INVOICING. 


Note: When you use an 
AUTOEXEC.BAT file MS-DOS does not 
prompt you for the date and time 
entries unless you include the DATE 
and TIME commands in the file. 
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An AUTOEXEC.BAT file may contain 
either one command or long series of 
commands. 


See Chapter 6, Batch Processing 
Commands, for more information. 
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Helpful Hints 


@ Make copies of your important program and data diskettes 
regularly. Always date the label. 


@ Print a directory frequently and store the listing with the 
diskette. 


@ If acommand does not work as it should: 


— Check your typing. 


— Make sure you have the correct diskette 
in the correct drive. 


— Check the directory of the diskette with 
the DIR command. 


— Make sure colons and spaces have been 
included where they should be and not where 
they don’t belong. 


— Make sure the filename is correctly spelled 
and includes the extension where appropriate. 


@ Ifacommand still does not work the way you expect it to, 
refer to Chapter 5, MS-DOS Commands for more 
information about that command. 
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Introduction 


This chapter describes the MS-DOS commands that are not 
specifically dedicated to batch processing files. The commands are 
in alphabetical order. 
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Command Syntax 


ur —-———qQVQuQuquuiii 


The following notation indicates how you should enter MS-DOS 
commands. Just like the rules of English grammar and usage, 
MS-DOS commands must be entered in an exact form—called 
command syntax. 


The following rules of command entry are used throughout this 
chapter to explain the proper way to express an MS-DOS command 
and all of its optional modifiers. 


You must enter any words shown in CAPITAL LETTERS. 
These words must be entered exactly as shown. You can make 
these entries in either upper-case or lower-case characters, but 
you must type them exactly as shown. MS-DOS accepts either 
upper-case or lower-case entries, but not misspellings. 


Anything enclosed in angle brackets (< >) must be entered. 
You supply the text. For example, enter the name of your file 
when <filename> is asked for in a command. Don’t type in 
the angle brackets; this would cause a problem. 


Items in square brackets ({ ]) are optional. Enter only the 
information asked for within the brackets. Don’t type in the 
square brackets; this would cause a problem. 


Items in braces ({ }) indicate that you must make a choice 
between two entries. You must enter one or the other unless 
those choices are enclosed in surrounding square brackets. 


An ellipsis (...) indicates that you may repeat an entry as many 
times as you need. 
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Enter all punctuation shown (with the exception of angle and 
square brackets, ellipses, braces, or in special cases, vertical 
bars), such as commas, equal signs, question marks, colons, or 
slashes. These punctuation marks are essential and must be 
entered exactly as shown. 


@ A vertical bar (1) appearing in a command entry means one of 
two things. In one case, the | indicates a choice between two 
required entries. It means “this” or “that” choice must be 
made. See the BREAK command for an example. In this case, 
the vertical bar is not typed in the command line. 


In another case, the vertical bar is used in the command entry to 
pass the results from one command to the next command on the 
command line. When | is used in this way, the results from the 
first command are passed to the second MS-DOS command for 
further processing. The second MS-DOS command is a “filter.” 
The symbol is called a “pipe.” See the SORT command for an 
example of piping the output from one command to another. 


You can also use a pipe when you want to send the results of a 
command to a file. For example, 


DIR | SORT >DIREC.FIL 


sends the results of a DIR command to the SORT command, then 
writes the SORT results into a file named DIREC.FIL. Note the 
use of the > symbol. 
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MS-DOS normally assumes that input comes from your keyboard 
and that output is displayed on your screen. You can redirect the 
flow of input and output using the < and > characters. Input can 
come from a file instead of the keyboard, and output can go toa 
file instead of the screen. The pipe character can also be used with 
redirection characters to make complex MS-DOS operations easier 
to do. 


For example, 
DIR 

displays a directory listing on your screen. If you enter 
DIR >DIRFILE 


the output of the DIR command is written into a file on the 
default drive named DIRFILE. If the file named DIRFILE is not 
already on the default drive, it is created. If it already exists, the 
output from the DIR command writes over the contents of the 
existing file. 


To append the output of the DIR command to the existing 
DIRFILE, use two >> symbols. For example, 


DIR >>DIRFILE 


appends the output from DIR to an existing file. If DIRFILE 
doesn’t already exist, it is created. See the SORT command for an 


example. 
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MS-DOS Commands 


The following MS-DOS commands are described in this chapter. 


Note: Synonyms for commands are enclosed in 
parentheses. 


Command Function 


ASSIGN Routes requests for one drive to another 

BACKUP Backs up files from a fixed disk 

BREAK Sets CONTROL-C check 

CHDIR Changes directories; prints working directory (CD) 
CHKDSK Scans the directory of the current drive and checks for consistency 
CHMOD Changes and displays file and/or directory attributes 
CLS. Clears screen 

COMP Compares files 

COPY Copies file(s) specified 

CTTY Changes the device used by MS-DOS for command input 
DATE Displays and sets date 

DEL Deletes file(s) specified (ERASE) 

DIK Lists requested directory entries 


DISKCOMP Compares the contents of two diskettes 
DISKCOPY Copies diskettes 


ERASE Same as DELete 

EXE2BIN Converts executable files to a binary format 
FC Compares files 

FDISK Sets fixed disk partitions 

FIND Searches for a constant string of text 


FORMAT Formats a disk to receive MS-DOS files 
GRAPHICS Enables graphics from the screen to be printed on a graphics 


printer 
JOIN Joins a disk drive to a pathname 
LABEL Creates, changes, or deletes a volume label on a diskette 
MKDIR Makes a directory (MD) 
MODE Sets display, communication, and serial printer environments 
MORE Displays output one screen at a time 
PATH Sets a command search path 
PRINT Provides background print feature 
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PROMPT 
RECOVER 
REN 
RESTORE 
RMDIR 
SET 
SHARE 
SHIP 
SIZE 
SORT 
SUBST 
SYS 

TIME 
TREE 
TYPE 
VER 
VERIFY 
VOL 


Designates command prompt 

Recovers a bad disk 

Renames firstfile a second file (REN) 

Restores files saved with BACKUP 

Removes a directory (RD) 

Assigns a value to an environment variable 
Shares files 

Prepares the fixed disk for shipping 

Lists filenames and file sizes of specified files 
Sorts data alphabetically, forward or backwards 
Substitutes a string for a pathname 

Transfers MS-DOS system files from one drive to another 
Displays and sets time 

Displays directories and their contents 

Displays the contents of file specified 

Prints MS-DOS version number 

Verifies writes to disk 

Prints volume identification number 


MS-DOS batch commands are described in Chapter 6, Batch 
Processing Commands. 
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ANSLSYS 


7 


ANSLSYS Escape sequences are series of characters that you can 
use to define functions to MS-DOS. For information about 
ANSISYS Escape sequences, see Appendix G. 
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ASSIGN 
Se ee 


PURPOSE Instructs MS-DOS to use a different drive from 
the one that was specified for disk operations. 


SYNTAX ASSIGN [drivespecl = drivespec2] 


COMMENTS Enter only the drive letters. Do not enter the 
colons on the command line. 


Drivespecl is source drive, drivespec2 is the 
new destination drive. 


Entering the ASSIGN command without any 
original or destination parameters resets the 
current assignments to the default values. 


ASSIGN could be useful in an 
AUTOEXEC.BAT file. 


ASSIGN works unpredictably when used with 
the PRINT command. Do not use in this 
combination. 


DISKCOPY and DISKCOMP commands ignore 
drive assignments. 
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BACKUP 


PURPOSE 


SYNTAX 


Options 


Backs up one or more files from fixed disk to 
one or more diskettes. 


BACKUP <d:> [pathname] [filename] 
<d:> [/S] [/A] [/MV/D:mm-dd-yy] 


The SUBDIRECTORY option (/s), causes the 
files in all subdirectories to be backed up as 
well as the files in the specified directory. This 
includes subdirectories at all levels, both before 
and beyond the specified directory. 


The MODIFIED option (/m), will only backup 
the files that have been modified since the last 
backup. 


The APPEND option (/a), indicates that backed 
up files should be added to the files on the 
already started backup diskette in the specified 
drive. If this parameter is omitted, then there 
will be a warning message saying that all 
previously existing files on the diskette will be 
erased. 
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The DATE option (/d) can be used to back up 
files written only on or after the specified date. 
See the description of the DATE command in 
your MS-DOS operators manual for valid date 
formats. 


After you enter the BACKUP command, you 
will be prompted to insert a new diskette. Be 
aware that unless you have used the /a option, 
BACKUP will erase existing files on the 
diskette before it starts backing up the fixed 
disk. 


When BACKUP fills up a diskette, and if there 
are more files to backup, it will prompt you to 
insert another new disk. This procedure will be 
followed until BACKUP has finished. 


COMMENTS Use MS-DOS formatted diskettes only. The 
first parameter you specify is the fixed disk 
file(s) you want to back up. The second 
parameter is the disk drive with the backup 
diskette. 


If you do not specify a path, files will be backed 
up from just the current directory. If you do 
not specify filename or extension, then all files 
in the current directory will be backed up. 
Global characters are allowed in filenames. 
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BACKUP will display the name of each file as 
it is backed up. If you want a printed copy of 
this list, you can use redirection to output to 
the printer. 


Note: The files as they exist on the 
backup diskettes are unusable in 
normal processing. They can only be 
used by the RESTORE command. 


The BACKUP command will set the exit code 
that can be used in a batch processing file with 
an IF command. These exit codes are: 


0 Normal completion 

1 No files were found to backup 
3 Terminated by user 

4 Terminated due to an error. 


It is wise to label each diskette and record the 
date and a sequential diskette number. The 
diskettes must be restored in a sequential 
order. 
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BREAK 


PURPOSE Sets the (€rR)C check. 
SYNTAX BREAK [ONIOFF] 


COMMENTS You use this option to prevent MS-DOS from 
being affected by a (rRC entry when the 
program you are using uses these keystrokes 
for another purpose. 


Select BREAK OFF to turn off (RC when 
you are running a program that uses these 
keystrokes. Select BREAK ON when you 
return to MS-DOS. 


If you do not select ON or OFF, MS-DOS 
displays the current setting of BREAK. 


Set BREAK ON to stop assemble or compile 
processes. See the System Programmer’s 
Guide for more information. 
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CHDIR (CHange DIRectory) 


PURPOSE 


SYNTAX 


SYNONYM 


COMMENTS 


Changes directory to a different path; displays 
working directory. 


CHDIR [pathname] 
cD 


If your present working directory is 
\BIN\USER\JOE and you want to change your 
working directory to another directory (such as 
\BIN\USER\JOE\FORMS), type: 


chdir \bin\user\joe\forms 


and press (RETURN). 


MS-DOS will put you in the new directory. A 
shorthand notation for the CHDIR command is 
also available: 


chdir .. 
or 
ed. 
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This command will always put you in the 
parent directory of your working directory. 


CHDIR used without a pathname displays your 
working directory. If your working directory is 
\BIN\USER\JOE on drive B, and you type: 


Chdir 


then press (RETURN), MS-DOS displays: 


b:\bin\user\ joe 


Using the CHDIR command in this way is 
useful when you need to know the name of your 
working directory. The command: 


chdir b: 
will display the working directory on drive B. 
To return to your ROOT directory, type either: 


CHDIR\ 
or 


CcD\ 
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CHKDSK (CHecK DiSK) 


PURPOSE 


SYNTAX 


Options 


COMMENTS 


Scans the directory of a specified disk to check 
that it is consistent with the files on the disk. 


Note: This command does not 
work over a network. 


CHKDSK [d:] {filename} (/F] (/V] 


chkdsk will not correct any errors found in 
your directory unless you specify the /F (fix) 
option. If you specify the /V option, chkdsk will 
display messages while it is running. The /F 
option will fix errors found in the directory. 


chkdsk should be run occasionally on each disk 
to check for errors. If any errors are found, 
chkdsk will display error messages, if any, and 
then display a status report. 


A sample status report looks like this: 


160256 bytes total disk space 
8192 bytes in 2 hidden files 
512 bytes in 2 directories 

30720 bytes in 8 user files 

121344 bytes available on disk 


65536 bytes total memory 
53152 bytes free 
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If you type a filename after chkdsk, MS-DOS 
displays a status report for the diskette and for 
the individual file. 


You can redirect the output from chkdsk to a 
file, if you want to save the status report for 
future use. Simply type: 


chkdsk a:>filename 


The errors will be sent to the filename 
specified. Do not use the /F option if you 
redirect chkdsk output. 
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CHKDSK may display one of the following 
error messages: 


Invalid drive specification 
Invalid parameter 
Invalid subdirectory entry 


Cannot CHDIR to ROOT 
Processing cannot continue 


First cluster number is invalid 
entry truncated 


Allocation error, size adjusted 
Has invalid cluster, file truncated 
Disk error reading FAT 

Disk error writing FAT 


Filename contains noncontiguous blocks. 


Call your dealer for assistance if you cannot fix 
any of these problems. 
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CHMOD 
PURPOSE Change and display file and/or directory 
attributes. 
SYNTAX CHMOD <d:> [pathname] [filename] 


[+s] [+r] [+1-h] [+/a] [++-v] 


COMMENTS CHMOD is used to change, modify, or list file 
or subdirectory attributes. The files attributes 
can be combinations of the following: 


s 


System file — files used by the 
operating system. Normally 
these files are hidden from the 
users of 

MS-DOS. 


Read only file — these files 
can only be read from, not 
written to. 


Hidden file — another file 
hidden from normal use by MS- 
DOS. 


Archive file — a file that has 

not been backed up. Every time 
that MS-DOS appends or creates 
a file, this attribute is turned on. 
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Vv Volume ID — nota file. An 11 
character ID name to help in the 
identification of diskettes. 


<dir> Directory — not a file. 
Another directory that has 
information about other files. 


Using this utility, you can set or clear any of 
the file attributes except the Volume ID and 
the DIRECTORY attributes. Global characters 
are allowed in filenames. 


To set an attribute for any file, enter a (+) plus 
sign after the filename followed by the 
attribute letter-code. Any letter-code entered 
without a set or clear option will default to 
setting the attribute, a (+) plus sign. 


To clear an attribute, enter a (-) minus sign 
followed by the attribute letter-code to be 
cleared. 


If one or more attributes are entered at any 
one time, spaces are ignored. If there is an 
error during input such as an improper 
attribute or filename, CHMOD will identify 
itself and display its options with proper usage. 
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CHMOD A:*.* 


will display attributes for the current 
directory on drive A. 


CHMOD B:\pathname\*.dat 


will display attributes for all filenames 
with the extension .DAT in the 
subdirectory pathname. 


CHMOD diskcopy.exe +h+r 


will set the HIDDEN and READ ONLY 
attributes for the filename 
DISKCOPY.EXE. 


CHMOD b:\overlays\wsmsgs.ovr -r 


will clear the READ ONLY attribute from 
the filename WSMSGS.OVR in the 
subdirectory OVERLAYS on drive B. 
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Entering: CHMOD b:*.* 


for an MS-DOS System diskette with a 
Volume ID of WP and a subdirectory name 
OVERLAY provided the following output: 


b: ibmbio.com ASRH. 
b: ibmdos.com ASRH. 
b: command. com Wels 
b: wp <dir> 2... 
b: 

S files. 
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CLS 


PURPOSE Clears the terminal screen. The CLS command 
is often used in batch processing to clear the 
display before another command begins. 


SYNTAX CLS 


5-26 


MS-DOS Commands 


COMP 


PURPOSE 


SYNTAX 


Compares two files. Typically COMP would be 
run after the COPY command has been used to 
be sure that the files copied are identical. 


COMP [d:] [pathname] [filename] 
[d:] [path] (name{.ext]] 


The first parameter specifies the first file. The 
second parameter is the second file. The files 
may be on the same disk drive or different disk 
drives. The files may also have different paths 
or directories. 


Global filenames are allowed, causing all of the 
files matching the first filespec to be compared 
with the corresponding set of files in the second 
filespec. 


COMP will prompt for filenames if both the 
first and second parameters are missing, if the 
second parameter is missing or if no filename 
matches the first parameter. 


a 
ry 
y 
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If no disk drive is entered then COMP will use 
the default drive. If only a disk drive or path 
are entered, but no filename, COMP will use a 
filename of *.*. A complete path filename can 
be entered with either the first or the second 
parameter. 


By using only directory names, it is possible to 
compare all the files in one directory with all 
the corresponding files in another directory. 


As the compare operation continues, the names 
and paths are displayed. If a specified 
directory path is invalid, or the files are 
different sizes, or the second filespec cannot be 
found, an error message will be displayed. 


An error message is shown for each location 
that contains a discrepancy. The message 
shows the offset into the files and shows the 
mismatched bytes in hexadecimal. 


After there have been 10 errors, COMP quits 
the comparison with the message: 


10 Mismatches — ending compare 
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If all goes well with the comparison, COMP will 
display: 


Files compare Ok 


After comparing two files, compare will 
proceed to the next two files that match the 
filespec, until all requested files are compared. 
Compare will then display: 


Compare more files (Y/N)? 


Answering Y will continue the compare utility 
by prompting for two more filespec parameters. 
To end the compare utility, enter N. 


Note: A comparison will not take 
place if the file sizes are different. 
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Hint 


The message: 


EOF mark not found 


is not an error but a note of information. 


If the files to be compared are not on the same 
diskette as the COMP utility, enter COMP with 
no parameters. After COMP prompts for the 
parameters it needs, insert the diskette(s) you 
want and answer with the filenames to be 
compared. 
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CONFIG.SYS 


CONFIG.SYS is a special file that is processed automatically when 
MS-DOS starts. For information about CONFIG.SYS, see 
Appendix E, CONFIG.SYS. 
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COPY 


PURPOSE Copies one or more files to another disk. If you 
prefer, you can give the copies different names. 
This command also copies files on the same 
disk and appends files. 


SYNTAX copy [pathname] [pathname] {/V] [/A] [/B] 


Options The /V option causes MS-DOS to verify that 
the sectors written on the destination disk are 
recorded properly. Although there are rarely 
recording errors when you run Copy, you can 
verify that critical data has been correctly 
recorded. This option causes the Copy command 
to run more slowly because MS-DOS must 
check each entry recorded on the disk. An error 
is displayed if a write is not verified. 


The /A and /B options mean that the files 
being processed are ASCII or binary files. 
Each option applies to the filename preceding 
it, and to all remaining filenames in the 
command, until another /A or /B is 
encountered. 
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The following discussion applies to the /A 
option: 


When used with a source filename: 


/A Causes the file to be treated as an ASCII 
(text) file. Data in the file is copied up to 
but not including the first end-of-file mark 
(this is (GrR)Z). The remainder of the file 
is not copied. 


copy memo.txt /a letter.txt 
When used with a designation filename: 


/A Causes an end-of-file character to be added 
as the last character of the file. 


copy memo.txt letter.txt /a 


When you are appending files, the default 
option is always /a. 
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Option /B 


The following discussion applies to the /B 
option: 


When used with a source filename: 


/B Causes the entire file to be copied, 
including any end-of-file mark: 


copy report.asm /b report2.asm 
When used with a designation filename: 
/B Causes no end-of-file character to be added. 


copy report.asm report2.asm /b 


Note: If the source and destination 
files are both in the working directory, 
you may use filenames, rather than 
complete pathnames. 


If the second pathname is not given, the copy 
will be on the default drive and will have the 
same name as the original file (first 
pathname). 
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If the original file is on the default drive and 
the second pathname is not specified, the Copy 
command will quit. (Copying files to 
themselves is not allowed.) MS-DOS will 
display the error message: 


File cannot be copied onto itself 
0 File(s) copied 


The second option may take three forms: 


1. If the second option is a drive name only, 
the original file is copied with the original 
filename to the designated drive. (For 
example, copy memo.doc b: will make a 
copy on drive B named MEMO.DOC.) 


2. If the second option is a filename only, the 
original file is copied to a file on the 
default drive with the filename specified. 
(For example, copy memo.doc letter.doc 
will make a copy of MEMO.DOC, name it 
LETTER.DOC, and place it on the default 
drive.) 
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3. If the second option includes a drive name, 
the original file is copied to a file on the 
drive specified. (For example, copy 
memo.doc b:memo.doce will make a copy 
of memo.doc on the default drive, name the 
copy MEMO.DOC, and place the copy on 
the diskette in drive B.) 


To CONCATENATE files: 


The Copy command also allows you to join 
(concatenate) while copying files. Simply list 
any number of files as options to Copy, 
separated by +, then specify a destination file 
to send the combined files to. 


For example: 


copy intro.rpt + body.rpt + b:sum.rpt 
report 


This command combines files named 
INTRO.RPT, BODY.RPT, and SUM.RPT (on 
drive B) and places them in the file on the 
default drive called REPORT. 


To combine several files using wild cards into 
one file, you could type: 


copy *.lst combin.prn 
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This command takes all files with a filename 
extension of .LST and combines them into a file 
named COMBIN.PRN. 


In the following example, for each file found 
matching *.LST, that file is combined with the 
corresponding .REF file. The result is a file 
with the same filename but with the extension 
FILE1.REF to form FILE1.PRN; then 
XYZ.LST with XYZ.REF to form XYZ.PRN; 
and so on. 


copy *.lst + *.ref *.prn 


The following Copy command combines all files 
matching *.LST, then all files matching *.REF, 
into one file named COMBIN.PRN: 


copy *.lst + *.ref combin.prn 


Note: Do not try to append files where 
one of the source filenames has the 
same extension as the destination. For 
example, the following command is an 
error if ALL.LST already exists: 


copy *.Ist all.lst 


The error would not be detected, 
however, until ALL.LST is appended. At 
this point, ALL.LST could have already 
been destroyed. 
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Copy compares the filename of the input file 
with the filename of the destination. If they are 
the same, that one input file is skipped, and the 
error message Content of destination lost 
before copy is printed. Further joining 
proceeds normally. This allows “summing” 
files, as in this example: 


copy all.lst + *Ist 


This command appends all *.LST files, except 
ALL.LST itself, to ALL.LST. This command 
will not produce an error message: 


copyx+yy 


This destroys y before it can be copied. 
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CTTY 


PURPOSE 


SYNTAX 


COMMENTS 


The CTTY command lets you change the device 
used by MS-DOS to accept command input 
(“TTY” is what MS-DOS calls your keyboard). 


CTTY <device> 


The <device> is the device from which you are 
giving commands to MS-DOS. This command is 
useful if you want to change the device on 
which you are working. The command: 


etty aux 


Moves all command I/O (input/output) from 
the current device (the console) to an AUX port 
such as another terminal. The command: 


etty con 


moves I/O back to the console. Refer to the 
“Tllegal Filenames” section of Chapter 1, “Files 
and Directories,” for a list of valid device 
names to use with the Ctty command. 


Note: There are many programs that 
do not use MS-DOS for input, output, or 
both. These programs do input directly 
to the hardware on your computer. The 
Ctty command will have no effect on 
these programs. Ctty will only affect 
programs that use MS-DOS. 
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DATE 


PURPOSE Enter or change the date known to the system. 
This date will be recorded in the directory for 
any files you create or change. 

You can change the date from your terminal or 
from a batch file. (MS-DOS does not display a 
prompt for the date if you use an 


AUTOEXEC.BAT file, so you may want to 
include a Date command in that file.) 


SYNTAX DATE [mm-dd-yy] 
COMMENTS If you type: 
date 
date will respond with the message: 


Current date is mm-dd-yy 
Enter new date_ 


Press if you do not want to change the 
date shown. 


You can also type a particular date after the 
Date command, as in: 


date 3-9-81 
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In this case, the Enter new date: prompt does 
not appear after you press (RETURN). 


Use ONLY the numbers listed below when you 
type the date. 


mm = 1-12 
dd = 1-31 
yy = 80-99 or 1980-2099 


The date, month, and year entries may be 
separated by hyphens (-) or slashes (/). 
MS-DOS is programmed to change months and 
years correctly, whether the month has 31, 30, 
29, or 28 days. MS-DOS handles leap years, too. 


5-41 


MS-DOS Commands 


DEL (DELete) 


$< 


PURPOSE Deletes all files with the designated file 
specification. Sometimes referred to as “erase.” 


SYNTAX DEL{pathname] 
COMMENTS You can use ERASE instead of DELete. 


If the pathname is *.*, the prompt Are you 
sure? appears. If Y is typed as a response, 
then all files on the diskette are deleted. 


NOTE BE CAREFUL. If you use wild-card characters 
to describe a pathname, you may DELete more 
files than you intended. For example, the 
pathname: 


DEL A:*.* 
causes the message: 
Are you sure? 


to be displayed. If you type Y or y asa 
response, then all the files on that diskette are 
removed. 
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DIR (DIRectory) 


PURPOSE 


SYNTAX 


Options 


COMMENTS 


Lists the files in a directory. 
DIR [pathname] {/P] (/W] 


Two options may be used with Dir. The /P 
option selects Page Mode. With /P, display of 
the directory pauses after the screen is filled. 
To resume display of output, press any key. 


The /W option selects wide display. With /W, 
only filenames are displayed, without other file 
information. Files are displayed five per line. 


If you just type DIR, all directory entries on 
the default drive are listed. 


If you include a drive name, such as 
“dir b:”, all entries on the diskette in the 
specified drive are listed. 
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If only a filename is entered with no 
extension (“dir name”), then all files with 
the designated filename on the diskette in the 
default drive are listed. 


When you type a filename with a drive 
letter (for example, “dir b:name.ext”), all 
files with the filename specified on the diskette 
in the drive specified are displayed. In all cases, 
files are listed with their size in bytes and with 
the time and date of their last modification. 


The wild-cards ? and * (question mark and 
asterisk) may be used in the filename option. 
Note that the following Dir commands are 
equivalent: 


COMMAND EQUIVALENT 


dir dir *.* 
dir filename dir filename.* 
dir .ext dir *.ext 
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DISKCOMP 


PURPOSE 


SYNTAX 


COMMENTS 


Compares the contents of the diskette in the 
first specified drive to the contents of the 
diskette in the second specified drive. Usually, 
you would run DISKCOMP after a DISKCOPY 
operation to ensure that the two diskettes are 
identical. 


DISKCOMP (4:] [d:] {/1} [/8] 


You can specify the same drive or different 
drives in this command. If you specify the 
same drive, a single-drive comparison is 
performed. 


DISKCOMP compares all tracks on a track- 
for-track basis and issues a message if the 
tracks are not equal. The message indicates the 
track number and the side (0 or 1) where the 
mismatch was found. 


After completing the comparison, DISKCOMP 
prompts: 


Compare more diskettes CY/N)?_ 


To end the command, press N. 


o 
b 
a 
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ae 


If you omit the second parameter, the default 
drive is used as the secondary drive. If you 
specify the default drive in the first parameter, 
this also results in a single-drive comparison. 


DISKCOMP automatically determines the 
number of sides and the number of sectors per 
track to be compared based on the diskette 
that is to be read first (the first drive 
parameter entered). 


Options 


/1 The /1 option forces DISKCOMP to 
compare only the first side of the diskette, 
even if the diskette is dual-sided. 


/8 The /8 option causes DISKCOMP to 
compare only eight sectors per track, even 
if the first diskette contains nine sectors 
per track. 
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DISKCOPY 


PURPOSE 


SYNTAX 


COMMENTS 


Copies the contents of the diskette in the 
source drive to the diskette in the destination 
drive. 


Note: This command does not 
work over a network. 


DISKCOPY ([d:] (d:] 


The first option you specify is the source drive. 
The second option is the destination drive. 


You can specify the same drives or you may 
specify different drives. If the drives are the 
same, a single-drive copy operation is 
performed. You are prompted to insert the 
disks at the appropriate times. Diskcopy waits 
for you to press any key before continuing. 


After copying, Diskeopy prompts: 


Copy complete 
Copy another CY/N)?_ 
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If you press Y, MS-DOS will prompt you to 
insert source and destination disks, and the 
next copy is performed on the same drives that 
you originally specified. 


To end the Diskcopy process, press N. 


Note 1: If you omit both options, a 
single-drive copy operation is 
performed on the default drive. 


Note 2: If you omit the second option, 
the default drive is used as the 
destination drive. 


Note 3: Disks that have had a lot of 
files created and deleted on them 
become fragmented, because disk space 
is not allocated sequentially. The first 
free sector found is the next sector 
allocated, regardless of its location on 
the disk. 
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A fragmented disk can cause slowness due to 
delays in finding, reading, or writing a file. If 
this is the case, you must use the Copy 
command, instead of Diskcopy, to copy your 
disk. Because the Copy command copies files 
sequentially to a disk, the new disk will not be 
fragmented. 


For example: 
copy a:*.* b: 


copies all files from the diskette in drive A to 
the diskette in drive B. 


Note 4: Diskcopy figures out the 
number of sides to copy, based on the 
source drive and disk. 
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EXE2BIN 
ee 


Converts .EXE (executable) files to binary file format. 


Using EXE2BIN results in faster program loading and conserves 
space on the disk. For information about EXE2BIN, see 
Appendix F, EXE2BIN. 
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FC (File Compare) 


PURPOSE 


SYNTAX 


COMMENTS 


The File Compare utility compares the contents 
of two files. 


FC [/#] [/B] (/C] (/W] <filename1> 
<filename2> 


If you have copied a file and modified the copy, 
you may later want to compare copies to check 
the changes you have made. You can use File 
Compare to do this and direct that the 
differences between the two files be output to 
the screen or to a third file. 


The files being compared may be either source 
files (files containing source statements of a 
programming language) or binary files (output 
from an assembler, a linker utility, or a high- 
level language compiler). 


The comparisons are either on a line-by-line or 
a byte-by-byte basis. Line-by-line comparison 
isolates blocks of lines that are different 
between the two files and prints those blocks of 
lines. This is the default method. If there are 
too many differences (too many lines), the 
program simply reports that the files are 
different and stops. If no matches are found 
after the first difference, FC displays: 


ee* Files are different *** 


and returns to MS-DOS default drive prompt. 
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Options 


The byte-by-byte comparison displays the bytes 
that are different between the two files. For 
binary files larger than available memory, FC 
compares both files completely, overlaying the 
portion in memory with the next portion from 
disk. All differences are output in the same 
manner as those files that fit completely in 
memory. 


The following options are used with FC. 


/# Number of lines required to match for the 
files to be considered as matching again 
after a difference has been found. # can 
be any number from 1 to 9, but 3 is 
reserved for default. Use only in source 
comparisons. 


/B_ Binary comparison of both files is 
performed. The two files are compared 
byte-by-byte with no attempt to re- 
synchronize after a mismatch. 
Mismatches are printed as follows: 


--ADDRS----F 1----F2- 


XXX KKK yy zz 


where xxxxxxx is the relative address of 
the pair of bytes from the beginning of 
the file. Addresses start at 00000000; yy 
and zz are the mismatched bytes from 
filel and file2, respectively. 


5-52 


/C 


/W 


MS-DOS Commands 


If one of the files contains less data than 
the other, a message appears. If, for 
example, F1 ends before F2, the following 
message appears: 


***Data left in F2aee* 


Ignore case of letters. All letters in the 
files are considered upper case. Use only 
in source comparisons. 


Compress whitespace (tabs and spaces) 
during comparison. Multiple contiguous 
whitespace in any line is considered as a 
single white space. Only beginning and 
ending whites are ignored. Use only in 
source comparisons. 
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EXAMPLES Assume these two ASCII files are on disk: 


ALPHA.ASM BETA.ASM 


NKMSACGHNDOVOAZZHTADVAVOWPE 
NxM Boe dGHNDOUVNE UH TAOWP 


One way to compare them is: 


FC ALPHA.ASM BETA.ASM 


wn 
bs 
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FC compares the two files and displays the 
differences on the screen. All defaults remain 
intact. The output appears as follows: 


ALPHA.ASM 
D NOTE: ALPHA file contains 
E DEFG,BETA contains G 
F 
G 
BETA.ASM 
G 
ALPHA.ASM 
M NOTE: ALPHA contains MNO, 
N BETA contains J12 
ie) 
P 
BETA.ASM 
J 
1 
2 
P 
ALPHA.ASM 
Ww NOTE: ALPHA contains W, 
BETA contains 45W 
BETA.ASM 
4 
5 
WwW 
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If you use: 
FC /B ALPHA.ASM BETA.ASM 


The following binary comparison appears. 


—ADDRS— —Fl— —F2— 
00000009 44 47 
0000000C 45 48 
0000000F 46 49 
00000012 47 4A 
00000015 48 31 
00000018 49 32 
0000000B 4D 50 
0000001E 4E 51 
00000021 4F 52 
00000024 50 53 
00000027 51 54 
0000002A 52 55 
0000002D 53 56 
00000030 54 34 
00000033 55 35 


*** DATA left in Fl *** 
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FDISK 


PURPOSE The FDISK command lets you set up a fixed 
disk drive to receive multiple operating 
systems. FDISK lets you create and define the 
operating system partitions on your fixed disk. 


SYNTAX FDISK 


COMMENTS For complete information refer to Using a 
Fixed Disk Drive in chapter 3, Starting 
MS-DOS. 


< 
& 
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FIND 


PURPOSE Searches for a specific string of text in a file or 
files. Find is an MS-DOS filter. It will display 
all lines that contain a specified string (group 
of characters) from the files in the command 
line. 


SYNTAX FIND [/V) {/C] [/N} 
<“string”> [d:] [pathname] 


Options Options for Find are: 


/V Causes Find to display all lines not 
containing the specified string. 


/C_ Causes Find to print only the count of lines 
that contained a match in each of the files. 


/N Causes each line to be preceded by its 
relative line number in the file. 


COMMENTS If no filenames are typed, Find takes the input, 
from the keyboard, and displays all lines that 
contain the specified string. 


n 
by 
B 
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The string must be enclosed by quotation 
marks: 


find “Fool’s Paradise” book1.txt book2.txt 


This command displays all lines from 
BOOK1.TXT and BOOK2.TXT (in that order) 
that contain the string “Fool’s Paradise.” The 
command 


dir b: | find /v “date” 


causes MS-DOS to display all names of the files 
on the diskette in drive B that do not contain 
the string “date.” Type double quotes around a 
string that already has quotes in it. 
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FORMAT 


_ jf 


PURPOSE Formats the diskette in the specified drive to 
accept MS-DOS files. 


Note: This command does not 
work over a network. 


SYNTAX FORMAT (d:] [/O} [/V] (/S] (/1, /4, or /8) 


Options The /O option causes Format to produce an PC 
DOS version 1.X compatible disk. This option 
reconfigures the directory with an OE5 hex 
byte at the start of each entry so that the disk 
may be used with 1.X versions of PC DOS, as 
well as MS-DOS 1.25/2.00 and PC DOS 2.00. 


You should use /O only when needed because it 
takes a fair amount of time for Format to 
perform the conversion, and it noticeably 
decreases MS-DOS performance on disks with 
few directory entries. 
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The /V option causes Format to prompt for a 
volume label after the disk is formatted. A 
volume label can be up to 11 characters long 
and is used to identify the disk. An example 
volume label is PROGRAMS. 


If the /S option is specified, it must be the last 
option typed; then Format copies the hidden 
files from the diskette in the default drive to 
the newly formatted disk. The files are copied 
in the following order: 


IBMBIO.COM 
IBMDOS.COM 
COMMAND.COM 


Use the /1 option to format the target diskette 
for single-sided use. 


Use the /4 option to format the target diskette 
as a 360-Kbyte doubled-sided/double-density 
diskette, for use in high capacity drives. A 
diskette formatted with this option, on a 1.2- 
Mbyte drive, may not be compatible with other 
360-Kbyte drives. 


Use the /8 option to format the target diskette 
for use at 8 sectors per track. The default is 9 
sectors per track. 


This command initializes the directory and file 
allocation tables. If no drive is specified, the 
diskette in the default drive is formatted. 
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GRAPHICS 


PURPOSE Allows the contents of a graphics display to be 
printed on an AT&T 473 Compatible Graphics 
Printer when using the color/graphics monitor 
adapter. This command will increase the 
resident size of MS-DOS in memory of 736 
bytes. 


SYNTAX GRAPHICS 


COMMENTS After loading GRAPHICS into the memory of 
your computer, press and hold (SHiF1), then 
press (Pase) to direct the graphics displayed on 
the screen to the graphics-compatible printer. 


The GRAPHICS command defaults to a 
standard printer. Use the MODE command to 
set other parameters that are required for your 
own printer. 


If color graphics are used, the screen image is 
printed in up to 4 shades of gray. 
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JOIN 


Joins a disk drive to a specific pathname 
(correct path). 


JOIN <d:> <d:><pathname> [/D] 


If the pathname does not exist, MS-DOS 
tries to make a directory with that pathname. 
The path must be empty. After you issue the 
Join command, the first drive name becomes 
invalid; and if you try to use it, MS-DOS 
displays the error message, “Invalid drive.” 


The Join command removes the distinction that 
physical drives are separately addressable by 
drive letter. This way you can always refer to 
all the directories on a specific drive by one 
pathname. If the path already existed before 
the Join command was typed, it will not be 
usable while the join is in effect. 


You can only join a drive at the root. The 
following command will work: 


join d: c:\memos 
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The following command will NOT work: 
join d: c:\memos\june 


To unassign a splice (“unjoin”), use the 
following format: 


join <d:> /d 


where <d:> represents the source drive and the 
/d option turns off the Join command. If you 
just type: 


join 


MS-DOS displays the current drives that are 
joined. 
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LABEL 


PURPOSE 


SYNTAX 


COMMENTS 


Allows you to create, change, or delete a 
volume label on a disk. 


LABEL [d:] [volume-label] 


If you do not specify a volume-label, you are 
prompted with the following message: 


Volume label (11 characters, 
ENTER ‘*return’’ for none)? 


To give the disk a volume label, type the label 
you want and press (RETURN). 


To change an existing volume label, type the 
new volume label and press (RETURN). The new 
label you typed replaces the existing volume 
label. 


To delete a volume label, do not specify a 
volume label; just press (RETURN). The volume 
label on the disk is deleted. 


Note: If you type more than 11 
characters for the volume label, only 
the first 11 characters are used. 
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LINK 


LINK is an executable program that combines object modules, that 
are the output of the MACRO-86 assembler or a compatible 
compiler. For more information, see Appendix C, LINK. 


5-66 


MS-DOS Commands 


MKDIR (MaKe DIRectory) 


———— 


PURPOSE 


SYNTAX 


COMMENTS 


This command creates a hierarchical directory 
structure. 


MKDIR [pathname] 


When you are in your root directory, you can 
create subdirectories by using the MKDIR 
command. The command: 


mkdir \user 


will create a subdirectory \USER in your root 
directory. To create a directory named JOE 
under \USER, type: 


mkdir \user\joe 


When you create directories with MKDIR, they 
always appear under your working directory 
unless you explicitly specify a different 
pathname with MKDIR. 
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PURPOSE 


SYNTAX 


COMMENTS 


MODE 


Lets you define some of the operating 
characteristics of your computer. 


MODE Ipt#4C} [,{M] 
or 

MODE N 

or 

MODE [N},M{,T] 

or 


MODE COMn:baud{,parity 
[databits|,stopbits{,P]]]] 


or 


MODE LPT#:=COMn © 


The MODE command has four format options. 
Any missing or invalid parameter will leave 
that parameter unchanged. 
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Printer For the parallel printer: 
Option 


Note: For serial printers, see ACI 
Port Option. 


MODE LPT#,{C] [,M] 
where: 


# isl, 2, or 3 — printer number 
C_ is 80 or 182 — characters per line 
M is6 or 8 — lines per inch vertical spacing 


MODE LPT1:132,8 


will set the mode of operation for printer 1 to 
132 characters per line and 8 lines per inch 
spacing. Default options at power-on for the 
printer are 80 characters per line and 6 lines 
per inch. 
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Display For setting the display mode: 
Mode Option 

MODE N 

or 


MODE N{,MJ,T] 
where: 
N Is 40, 80, BW40, C040, CO80, or MONO 


40 This sets the displays width to 40 
characters per line. 


80 This sets the display width to 80 
characters per line. 


BW40 If you have a monochrome and a color 
display attached to your computer, this 
selects the color display to be active, 
sets the display mode to black and 
white, and sets the display width to 40 
characters per line. 


5-70 


MS-DOS Commands 


BW80 If you have a monochrome and a color 


C040 


Co80 


display attached to your computer, this 
selects the color display to be active, 
sets the display mode to black and 
white, and sets the display width to 80 
characters per line. 


If you have a monochrome and a color 
display attached to your computer, this 
selects the color display to be active, 
sets the display mode to color, and sets 
the display width to 40 characters per 
line. 


If you have a monochrome and a color 
display attached to your computer, this 
selects the color display to be active, 
sets the display mode to color, and sets 
the display width to 80 characters per 
line. 


MONO If you have a monochrome and a color 


display attached to your computer, this 
selects the monochrome display to be 
active. The width for monochrome 
displays is always 80 characters per 
line. 
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M Is R or L (shift display right or left). 


HW Requests a test pattern used to align 
the display. 


For readability, the display can be shifted to 
the right or left (one character for 40 columns 
or two characters for 80 columns). If the T 
parameter is specified, a prompt asks you if the 
screen is properly aligned. Answering Y will 
end the command. Entering N will shift the 
display again in the same direction and the 
prompt is also displayed again. For example: 


MODE 80,L,T 


sets the mode of operation to 80 characters per 
line and shifts the display two character 
positions to the left. The test pattern is again 
displayed to allow you to shift the display 
again. 
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ee ee eS 


ACL Port For Asynchronous Communications Interface 
Option port (e.g. serial printer): 


Note: For parallel printers, see 
Printer Options. 


MODE COMn:baud{,parity 
[databits[,stopbits[,P]]]] 


where: 

n Either 1 or 2 (Asynchronous 
Communications Interface port 
number) 


baud 110, 150, 300, 600, 1200, 2400, 4800, or 
9600 


Note: Only the first two 
characters of the baud rate 
number are required; the 
subsequent characters are 
ignored. 


parity Either N (none), O (odd), or 
E (even)—(default = E) 


databits Either 7 or 8 (default = 7) 
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stopbits Either 1 or 2 (if baud equals 110, 
default = 2; if baud does not equal 
110, default = 1) 


These are the communications protocol 
parameters. They are used to initialize the 
Asynchronous Communications Interface port. 
When you specify the parameters, you must at 
least specify the baud rate. The other 
parameters can be omitted with the defaults 
accepted, by entering only commas: 


MODE COM1:12,N,8,1,P. 


sets the mode of operation to 1200 baud rate, no 
parity, eight databits, and one stopbit. 


To use the defaults listed in the definition 
above, you enter: 


MODE COM1:12,,,,P 


The parity defaults to even, the databits 
defaults to seven, and the stopbits defaults to 
one. 


Redirect 
Option 
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The P option indicates that the asynchronous 
adapter is being used for a serial interface 
printer. If you enter the P option, time-out 
errors are continuously retried. By pressing 
(Giri) (BREAK), you can stop the retry loop. To 
stop the time-out errors from being 
continuously retried when you have entered the 
P parameter, you must reinitialize the 
Asynchronous Communications Interface port 
protocol without entering the P. 


To redirect parallel printer output to an 
Asynchronous Communications Interface port: 


MODE LPT#:=COMn 
where: 
# Either 1, 2, or 3 — printer 


n Kither 1 or 2 — Asynchronous 
Communications Interface port number 


All output directed to printer LPT# will be 
redirected to the Asynchronous Interface port 
n. 
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Note 1: Before you can use MODE to 
redirect parallel printer output to a 
serial device, you must initialize the 
Asynchronous Communications 
Interface port by using Option 3. If 
that serial device is a printer, your 
serial initialization command should 
also include the P parameter. 


Note 2: A normal printer mode 
command, MODE LPT#;[n], [,m], 
disables the redirection for the printer 
designated by the #. 
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MORE 


PURPOSE 


SYNTAX 


COMMENTS 


Sends output to the console one screen at a 
time. 


MORE 


MORE is an MS-DOS filter that reads from 
standard input (such as a command from your 
terminal) and displays one screen of 
information at a time. The More command 
pauses and then displays --More-- at the 
bottom of your screen. 


Pressing (RETURN) displays another screen of 
information. This process continues until all 
the data has been read. 


The More command is useful for viewing a long 
file one screen at a time. If you type: 


type myfiles.new | more 


MS-DOS will display the file MYFILES.NEW 
one screen at a time. 
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PATH 
PURPOSE Sets a command search path. 
SYNTAX PATH =(pathname|;pathname|...] 


COMMENTS This command allows you to tell MS-DOS 
which directories should be searched for 
external commands after MS-DOS searches 
your working directory. The default value is no 
path. 


To tell MS-DOS to search the \USER\JOE 
directory for external commands, type: 


path \user\joe 


MS-DOS now searches the \USER\JOE 
directory for external commands until you set 
another path or exit MS-DOS. 
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You can tell MS-DOS to search more than one 
path by specifying several pathnames separated 
by semicolons. For example, 


path \user\joe;b:\user\sue;\bin\dev 


tells MS-DOS to search the directories specified 
by the above pathnames to find external 
commands. MS-DOS searches the pathnames in 
the order specified in the Path command. 


The command, Path, with no options will print 
the current path. If you specify, 


path ; 


MS-DOS will set the NUL path. This means 
that only the working directory will be 
searched for external commands. 
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PRINT 


PURPOSE Prints a text file on a line printer while you are 
processing other MS-DOS commands (usually 
called “background printing”). 


SYNTAX PRINT (pathname) (/T] {/C] [/P]] 


Options You will use the Print command only if you 
have a line printer attached to your computer. 
The following options are provided with this 
command: 


/T TERMINATE. This option deletes all files 
in the print queue (those waiting to be 
printed). A message to this effect will be 
printed. 


/C CANCEL. This option turns on the cancel 
mode. This suspends printing of the 
specified file and all subsequent files until 
a /P option is entered. 


/P PRINT. This option turns on the print 
mode. The preceding filename and all 
following filenames will be added to the 
print queue. 


COMMENTS 
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Print, when used with no options, displays the 
contents of the print queue on your screen 
without affecting the queue: 


print /t 


Empties the print queue. 


print a:temp1.tst /e a:temp2.tst 
a:temp3.tst 


Cancels the printed output of the TEMP1.TST 


file and suspends the operation of the print 
queue until the /p option is entered. 


print temp1.tst /e temp2.tst /p temp3.tst 


Removes TEMP1.TST from the queue, and adds 
TEMP2.TST and TEMP3.TST to the queue. 
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PROMPT 
PURPOSE Changes the MS-DOS command prompt. 
SYNTAX PROMPT [promptext] 


COMMENTS This command allows you to change the MS- 
DOS system prompt (A>). If no text is typed, 
the prompt will be set to the default prompt, 
which is the default drive designation. You can 
set the prompt to a special prompt, such as the 
current time, by using the characters indicated 
below. 


The following characters can be used in the 
prompt command to specify special prompts. 
They must all be preceded by a dollar sign ($): 


Character Specify This (Prompt): 


$ The ’$’ character 

t The current time 

d The current date 

Pp The working directory of the 
default drive 

v The version number 

n The default drive 

g The '>’ character 

1 The ’<’ character 

b The '’ character 

A carriage return-line feed 

sequence 

s A space (leading only) 


EXAMPLE 1 


EXAMPLE 2 


EXAMPLE 3 
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h A backspace 
e ASCII code X’1B’ (escape) 
Prompt $p 


Sets the drive prompt to d: (current directory). 
Prompt Time = $t$_Date = $d 
Sets a two-line prompt which prints: 


Time = (current time) 
Date = (current date) 


If your terminal has an ANSI escape sequence 
driver, then you can use escape sequences in 
your prompts. To use this sequence, you must. 
load ANSI.SYS into the computer. For example: 


Prompt $e{7m$n:$e{m 


Sets the prompts in inverse video mode and 
returns to video mode for other text. 
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RECOVER 


PURPOSE Recovers a file or an entire diskette or fixed 
disk containing bad sectors. 


Note: This command does not 
work over a network. 


SYNTAX RECOVER <filename | d:> 


COMMENTS If a sector on a diskette is bad, you can recover 
either the file containing that sector (without 
the bad sector) or the entire diskette or fixed 
disk (if the bad sector was in the directory). 


To recover a particular file, type: 
recover <filename> 


This will cause MS-DOS to read the file sector 
by sector and to skip the bad sector(s). When 
MS-DOS finds the bad sector(s), the sector(s) 
are marked and 

MS-DOS will no longer allocate your data to 
that sector. 
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To recover a diskette or fixed disk, type: 
recover <d:> 


where d: is the letter of the drive containing 
the diskette to be recovered. 
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REN (REName) 


PURPOSE Changes the name of a file. 
SYNTAX REN <pathname> <filename> 


COMMENTS You must supply a drive name if the file 
resides on other than the default drive. The 
new filename is always created on the same 
drive or pathname as the source file. 


Wild cards may be used in either option. All 
files matching the first filename are renamed. 
If wild cards appear in the second filename, 
corresponding character positions will not be 
changed. For example, the following command 
changes the extension of all filenames ending 
in .LST to PRN: 


ren *.Ist *.prn 


In the next example, REN renames the file 
CHAP10 on drive B to PART10: 


ren b:chap10 part10 


The file remains on drive B. 
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RESTORE 


PURPOSE 


SYNTAX 


Options 


Restores files from one or more diskettes to a 
fixed disk, that were backed up using the 
BACKUP command. 


RESTORE <d:> <d:>(pathname] [filename] 
V/S) /P} 


The /S option causes backed up files in all 
subdirectories to be restored as well as the files 
in the specified directory itself. This includes 
subdirectories at all levels both before and 
beyond the specified directory. 


The /P option causes RESTORE to prompt you 
before restoring (writing over) files that have 
changed since they were last backed up, or that 
are marked read-only. You then have the 
option of restoring or not restoring. Read-only 
is a file attribute that an application can set by 
interfacing with MS-DOS internally or by using 
the CHMOD command. 
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COMMENTS 


EXAMPLE 1 


The files being restored must be files that have 
been backed up by the BACKUP command. 
The first parameter specified is the disk drive 
that contains the diskette being restored. The 
second parameter is the fixed disk file you 
want to restore. 


If you do not specify a path, files will be backed 
up to just the current directory. If you do not 
specify a filename or extension, then all files 
backed up from the directory will be restored. 


Global characters are allowed in the filename 
and will cause all of the files that match the 
filename to be restored. 


RESTORE A: C:\ /S 


Restores all files on the backup diskettes to 
fixed drive C. 
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RESTORE A: C:*.ASM 


Restores each file from the backup diskettes 
with an extension of .ASM that had originally 
been backed up from the current directory. 


This example restores three different files from 
the backup diskettes in drive A to the default 
fixed disk drives: 


RESTORE A: \path1\filenamel 
RESTORE A: \path1\path2\filename2 
RESTORE A: \path1\path3\filename3 


Note: When RESTORE prompts you 
to insert the backup diskette, make sure 
you insert the first diskette that might 
contain the file you want to restore. If 
you are not sure, insert backup diskette 
number one. If the file is not on the 
diskette you inserted, RESTORE will 
prompt you to insert the next diskette. 
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If a file was backed up on more than one 
diskette, you must restore the file using the 
diskettes in the same order as they were saved. 
See “Hints” in the BACKUP command section. 


If you used a global filename character, 
RESTORE will continue to prompt you to 
insert the next diskette even after it has 
restored all files on the backup diskette that 
match the specified filename. 


The RESTORE command will set the exit code 
number as follows: 


0 Normal completion 


1 No files were found to restore 


3 Terminated by user ( (ErRU), 


, or (Esc)) 
4 Terminated due to an error. 


These codes can be used with the batch 
processing IF subcommand to control 
subsequent error-level processing. 
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RMDIR (ReMove DIRectory) 


PURPOSE Removes a subdirectory from a multilevel 
directory structure. 


SYNTAX RMDIR <pathname> 
SYNONYM RD 


COMMENTS This command removes a directory that is 
empty except for the .'and .. shorthand 
symbols. You must delete all files in the 
directory first. 


EXAMPLE To remove the \USER\JOE directory, first 
issue a Dir command for that path to ensure 
that the directory is empty. Then type: 


del \user\joe\*.* 
rmdir \user\joe 


The directory will be deleted from the directory 
structure. 
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SET 


PURPOSE Sets a value to an environment variable to a 
string for use in later programs. 


SYNTAX set [<variable=string>] 


COMMENTS This command is meaningful only if you want 
to set values that will be used by programs you 
have written. 


More information about using the SET 
command appears in Chapter 6, Batch 
Processing Commands. 


EXAMPLE The command: 
set TTY=VT52 


sets your TTY value to VT52 until you change 
it with another Set command. If you just type: 


set 


MS-DOS displays the current environment 
strings. 
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SHARE 


PURPOSE 


SYNTAX 


Options 


COMMENTS 


EXAMPLE 


Installs file sharing and locking. 
SHARE [/f:space] [/L:locks] 


Use the /f:<space> option to allocate file 
space (in bytes) for the area MS-DOS uses to 
record filesharing information. Each file that is 
open needs the length of the full filename plus 
11 bytes (the average pathname is 20 bytes). 
The default value for the /f option is 2048 
bytes. 


The L:<locks> option allocates the number of 
locks you want to allow. The default value for 
the /L option is 20 locks. 


Once you have used the Share command in an 
MS-DOS session, all read and write requests 
are checked by MS-DOS. 


The Share command is only used when 
networking is active. It is included in the 
AUTOEXEC.BAT file to install shared files. 


The following example loads file sharing and 
uses the default values for the /f and /L 
options: 


share 
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PURPOSE 


SYNTAX 


COMMENTS 


SHIP 


Positions the heads on the internal fixed disk 
for shipment. 


SHIP 


Note: After you enter SHIP command, 
turn off the system immediately, since 
using the fixed disk moves the heads 
out of the shipping position. 


Use this command when you move a system 
containing an internal fixed disk. 


Refer to the manufacturer's instructions on 
moving any external fixed disk. 
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SIZE 


PURPOSE 


SYNTAX 


COMMENTS 


Hint 


EXAMPLE 1 


Lists filenames and file sizes of specified files. 
Shows the total number and total space 
required to contain them. 


SIZE [d:] [path] [filename] [d:] 


Use SIZE with a path or filename. Global 
characters are permitted. If no parameter is 
entered, the SIZE defaults to *.* of the current 
directory. 


SIZE lists files on the console like DIR, 
displaying the filename and file size, but sums 
up the total size of all the files. It is mostly 
useful for copying large amounts of files from 
fixed disk to floppies to see if the specified files 
will fit. 


SIZE *.* 


Lists all files with exact file sizes. 


o 
& 
& 
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EXAMPLE 2 


SIZE \BIN\*.COM 


produces the following: 


chkdsk.com 6400 
diskcopy.com 2576 
format.com 2534 


4 files, total of 18422 bytes. 


A list of all the files with the extension of COM 
in subdirectory \BIN. 


SIZE *.* B: 


Lists exact file sizes, plus the amount of disk 
space on B: needed by each file, plus the total 
amount of disk space needed for all files. 


If drive is specified as second argument, then 
the cluster size on the specified drive is used. 
There must be a diskette in the specified drive. 


If you want to list the files in another 
directory, you also must enter a filename. The 
filename can be the global. Entering: 


SIZE A:\PATH 


without a filename causes SIZE to return the 
number of files and sizes as zero. 
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SORT 


PURPOSE 


SYNTAX 


Options 


COMMENTS 


EXAMPLE 1 


Sort reads standard input, sorts the data, then 
writes it to your terminal screen, a file, or to 
another device. 


SORT [/R] [/+<N>] 


There are two options which allow you to select 
options: 


/R Reverses the sort; that is, sort from Z 
to A. 


/+<N> Sort starting with column n where n is 
some number. If you do not specify 
this option, Sort will begin sorting 
from column 1. 


Sort can be used, for example, to alphabetize a 
file by a certain column. 


This command reads the file UNSORT.TXT, 
reverses the sort, and then writes the output to 
a file named SORT.TXT: 


sort /r <unsort.txt> sort.txt 


o 
& 
3 
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EXAMPLE 2 


EXAMPLE 3 


The following command pipes the output of the 
directory command to the Sort filter. The Sort 
filter sorts the directory listing starting with 
column 14 (this is the column in the directory 
listing that contains the file size), then sends 
the output to the screen. The result of this 
command is a directory sorted by file size: 


dir | sort /+14 
The command: 
dir | sort /+14 | more 


will do the same thing as the command in the 
previous example, except that the More filter 
gives you a chance to read the sorted directory 
one screen at a time. 
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SUBST 


PURPOSE 


SYNTAX 


Option 


COMMENTS 


Substitutes a string alias for a pathname. 
SUBST [d:] [pathname] [/D] 


Uses the /D option to delete an associated drive 
or pathname. 


SUBST creates or deletes a “virtual drive” by 
associating a pathname with a drive letter. 


When MS-DOS sees a drive that was created 
with the SUBST command, it replaces the 
reference with the new pathname. 


If you type: 
subst 


MS-DOS displays the names of the “virtual 
drives” in effect. 
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EXAMPLE The command: 


subst z: b:\usr\fred\forms 


Creates a virtual drive Z for the pathname 
“b:\usr\fred\forms.” Now, instead of typing 
the full pathname, you can get to this directory 
by simply typing z. 
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SYS (SYStem) 


PURPOSE 


SYNTAX 


COMMENTS 


Copies the MS-DOS System files to the 
specified disk drive from the default drive. 


Note: This command does not 
work over a network. 


SYS <d:> 


SYS is normally used to update the system or 
to place the system on a formatted diskette 
that contains no files. You must type a drive 
letter with this command. 


If IBMBIO.COM and IBMDOS.COM are on the 
destination disk, they must take up the same 
amount of space on the disk as the new system 
will need. 


The destination diskette must be completely 
blank or already have the system files 
IBMBIO.COM and IBMDOS.COM. 


The transferred files are copied in the following 
order: 


IBMBIO.COM 
IBMDOS.COM 
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IBMBIO.COM and IBMDOS.COM are both 
hidden files that do not appear when you type 
the Dir command. COMMAND.COM (the 
command processor) is not transferred. Use the 
Copy command to transfer COMMAND.COM. 


It is safer to use the /S option with the 
FORMAT command to place a current version 
of the System files on a new disk, then copy all 
data and program files over to the new disk. 
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TIME 


PURPOSE 


SYNTAX 


COMMENTS 


Displays and sets the time. 
TIME [hours:{minutes]} 


If you just type “time,” the following message 
is displayed: 


Current time is hh:imm:ss.ce 


Enter new time:_ 


Press (RETURN) if you do not want to change the 
time shown. If you want to change the time 
after you have started MS-DOS, (for example, 
to set 8:20 a.m.), type: 


time 8:20 


in response to the MS-DOS prompt. The new 
time must be entered using numbers only; 
letters are not allowed. The two options are: 


hours = 00-23 
minutes = 00-59 
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Separate the hour and minute entries by a 
colon. You do not have to type the ss (seconds) 
or ee (hundredths of seconds). 


Tf you do not type a valid time, MS-DOS 
displays the message: 


Invalid time 


Enter new time:_ 


MS-DOS then waits for you to type a valid 
time. 
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TREE 


PURPOSE 


SYNTAX 


Options 


Displays directories and files, and optionally 
deletes files throughout the entire tree 
directory structure. 


TREE [d:] [filename] (/A] (/D] [/Q] 


TREE has three options that change the way it 
works. These are: 


/A Archive files 
/D Delete files 
/Q Question before every delete. 


If you specify option /A after filename, it will 
list only files that have the A, or Archive, 
attribute set. Whenever you modify the file in 
any way, MS-DOS sets the A attribute to mark 
it as “changed.” Programs such as BACKUP 
use this in determining what files need to be 
backed up. 


You can determine what files you have changed 


in any way on your disk by typing (from the 
root): 


TREE *.*/A 
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/D and /Q work together. A /D after the 
filename tells TREE to delete each file it finds. 
A typical use for this is for deleting all .BAK 
files from fixed disk with many subdirectories, 
where it would be tedious to enter each 
directory and do it manually. 


/Q causes TREE to ask “DELETE? (y/n)” 
before actually deleting the files it finds. This 
is helpful if you aren’t sure you want to delete 
all of them. /Q is necessary if you enter *.* as 
the filename; this prevents TREE from deleting 
the files in all subdirectories. You also have 
the option of entering ??? 2 as the 
filename. 


Example 1 TREE *.BAK/D 


Deletes all .BAK files found. 


Example 2 TREE *.BAK/D/Q 


Requires typing Y at the question to delete 
each file. 
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TREE is used to display files and subdirectory 
structure. The display starts with the current 
directory and displays all subdirectories down 
through the tree directory structure. 


You can also specify disk drive in the usual 
manner. TREE D: will list all the directories 
on drive D. 


Please note that you can enter full path 
specifier for TREE, like \bin\*.com. TREE will 
ignore \bin\, and use only the filename as 
mentioned above. It will not find just the 
specified files in \bin\. 


To pause the screen output, use the (GrRS keys 
or pipe the output to the MORE filter. 
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EXAMPLES The following examples will use the following 
directory structure of a disk called SYSTEM. 


\ROOT 
i} 
COMMAND . COM 
AUTOEXEC. BAT 
I 


| ' 


\DOs \BIN 
' I 
| DEBUG. COM | EDITOR.COM 
| SYS.COM | LETTER. TXT 
| MEMO. TXT 
1 
\BASIC 


| BASICA.COM 
| SINE.BAS 


Example 1 TREE 


entered with no parameters from the root 
directory would display: 


pos 
BIN 
BASIC 
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TREE entered from the \BIN subdirectory 
would be displayed as: 


BIN 
BASIC 


since TREE works from the current directory 
down to the lowest level it finds. It never looks 
“up” the tree to see \DOS subdirectory. 


TREE *.* 
entered with the *.* parameter would be: 


command. com 
autoexec.bat 
Dos 
debug.com 
sys.com 
BIN 
editor.com 
letter.txt 
memo.txt 
BASIC 
basica.com 


sine.bas 


9 files, S028 bytes. 
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Example 3 


Example 4 
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TREE *.TXT 


entered with the *.TXT parameter would be: 


Dos 

BIN 
letter.txt 
memo. txt 

BASIC 


2 files, 1024 bytes. 


The following is an example of using TREE to 
delete files. If you have a file DATES.BAS in 
several subdirectories on your disk, entering 
the following will delete them with the optional 
question: 


TREE date.bas/d/q 


pos 
BIN 

date.bas delete? Cy,n) deleted 
BASIC 

date.bas delete? Cy,n) deleted 


2 files, 512 bytes. 
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TYPE 


PURPOSE Displays the contents of a file on the screen. 
Use this command to view a file without 
modifying it. 


SYNTAX TYPE <filename> 


COMMENTS Note that when you use Type to display a file 
with tabs in it, all tabs are expanded to 8 
spaces wide. A display of binary files causes 
control characters (such as (CTRIJZ) to be sent 
to your computer, including bells, form feeds, 
and escape sequences. 


Use the MORE command with a TYPE 
command to view one screen at a time. 
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PURPOSE 


SYNTAX 


COMMENTS 


VER 


Prints MS-DOS version number. 
VER 


If you want to know what version of 
MS-DOS you are using, type: 


ver 


The version number will be displayed on your 
screen. 
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VERIFY 


PURPOSE 


SYNTAX 


COMMENTS 


Turns the verify option on or off when writing 
to disk. 


VERIFY [ONIOFF] 


Note: Do not abbreviate this 
command; ver is a different command. 


This command has the same purpose as the /V 
option in the Copy command. If you want to 
check that all your files are written correctly to 
disk, you can use the Verify command to tell 
MS-DOS to confirm that your files are intact 
(no bad sectors, for example). MS-DOS will 
perform a Verify each time you write data to a 
disk. You will receive an error message only if 
MS-DOS was unable to successfully write your 
data to disk. 


Verify ON remains in effect until you change it 
in a program (by a Set Verify system call), or 
until you type “Verify OFF.” 


If you want to know what the current setting of 
Verify is, type: 


verify 


with no options. 
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VOL (VOLume) 
ee ee es 
PURPOSE Displays disk volume label, if it exists. 


SYNTAX VOL [d:} 


COMMENTS This command prints the volume label of the 
disk in a specific drive. If you do not type a 
drive letter, MS-DOS prints the volume label of 
the diskette in the default drive. 
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Introduction 


HHH 


In your daily work, you may find yourself typing the same 
sequence of commands time and again to perform some frequently 
used task. Batch processing lets you combine a series of 
commands into a special file called a batch file, and execute the 
entire sequence by typing just the name of the batch file. 


The commands in a batch file are executed as if they had been 
typed at the keyboard. A batch file must be named with the BAT 
extension and is executed by typing the batch file name without 
the extension. 


You can create a batch file by using the Line Editor (EDLIN) or 
using the COPY command. Refer to the Section “How to Create 
an AUTOEXEC.BAT File” later in this chapter to find information 
on how to use COPY to create a batch file. 


A .BAT file may contain any MS-DOS command. The special 
MS-DOS commands described in this chapter let you control the 
tasks your batch processing files perform more closely. 


Here are some additional uses for batch command files: 


@ Automatically setting the MODE for your printer, monitor and 
communications lines. (Use AUTOEXEC.BAT) 


© Automatically going to a particular directory when you start 
up the system. (Use AUTOEXEC.BAT) 


© Automating a backup procedure to assure that the correct set 
of files is always backed up. 
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HOW TO If, for example, you wanted to automatically 
CREATE AN load GWBASIC and run your inventory 
AUTOEXEC.BAT program (called INVNTORY) every time you 
FILE started MS-DOS, here is how you would create 


the AUTOEXEC.BAT file for that purpose: 


1 If your current directory is not the Root 
directory, go back to the Root directory 
using the CHDIR command. 
AUTOEXEC.BAT must reside in the Root 
directory so that MS-DOS can find it when 
you start your system. 


2, Type: 


COPY CON: AUTOEXEC.BAT 


This statement tells MS-DOS to copy the 
information you enter through the 
keyboard (CONsole) to the 
AUTOEXEC.BAT file. 


3 Now type: 
GWBASIC INVNTORY 


This statement goes into the 
AUTOEXEC.BAT file and tells MS-DOS to 
load GWBASIC and run the inventory 
program whenever MS-DOS is started. 
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4 Press (crr)Z, then press (RETURN). 


The INVNTORY program will now run 
automatically whenever you start MS-DOS. 


Here is an example of another 
AUTOEXEC.BAT file: 


MODE COM1:12,e,7,1,p 
MODE LPT1:=COM1 
DIR /W 

PROMPT $p$g 


The first line of the file sets up 
communications port 1 to operate at 1200 baud 
(at even parity), with 7 data bits and 1 stop bit. 
This line will retry continuously, in case of a 
time-out error. This port will have a serial 
printer attached to it. 


The second line redirects the output that would 
normally go to printer LPT1 to COMI, the 
serial printer. 


The third command directs MS-DOS to display 
a directory of the default disk in the wide 
format. 
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The fourth line tells MS-DOS to display the 
name of the current directory instead of the 
normal prompt. For example, if the current 
directory was “work” on drive B, MS-DOS 
would prompt you with: 


work> 
instead of 


B> 
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Stopping Batch Processing 


Batch processing files are stopped by pressing (ctRIJC or (CTRL 
(Scriock). When you stop a batch file, the message: 


Abort batch job? (Y/N) 


appears on your screen. 


If you want to stop the batch file, press Y. If not, press N, and 
the task the batch file is performing continues. 
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Parameters in Batch Files 


Often you have repetitive tasks which are quite similar — perhaps 
differing only by the file being processed. A parameter is used to 
provide a filename to the .BAT file. This way, a batch file can 
immediately perform a task for you without having to be specially 
edited to match you current needs. 


For example, UPDATE (a .BAT file) could be run twice weekly as 
follows. On Wednesday night: 


A>BUPDATE.BAT MON.SLS TUES.SLS WEDS.SLS 
and on Saturday night: 
A>BUPDATE.BAT THURS.SLS FRI.SLS SAT.SLS 


Up to 10 parameters may be used. They are named %0, %1, %2, ... 
and %9. parameter values are located on the BAT command line 
separated by spaces in this format: 


A>B%O.BAT] %Z1 %2%3 %4 %5 %W6 M7 %8B%Y 


%0 is always the name of the .BAT file. 
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Variables in Batch Files 


Variables provide another way of passing specific data to a batch 
processing file. 


There is an important difference between variables and 
parameters. 


A variable is a text string (a name) enclosed by % signs, in this 
format — %variable%. Values are given to variables with the 
MS-DOS SET command. Once declared, a variable retains its value 
until you either reset it or turn the computer off. Thus, .BAT files 
pass values to other .BAT files and to the system. 


For example, if your batch file contains the statement: 
LINK %FILE% 


you can set the name that MS-DOS uses for that variable with 
the SET command. By entering 


SET FILE=DOMORE 


the %FILE% parameter is replaced with the filename DOMORE. 


This way, you don’t need to edit each batch file to change the 
replaceable parameter names. Remember that replaceable 
variables that have names must begin and end with a percent sign. 


When the variables in your batch file are numbered instead of 
specifically named, you can assign values to them when you start 
the file. Enter the variables in numeric order following the batch 
file name on the command line. Separate each parameter entry 
with a space. 
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The first variable (%0) must be the batch file name. It is not 
entered following the batch file name. The entries you make 
following the name of the batch file are variables %1, %2, etc. 


For example, assume you have three variables in your batch file 
numbered %1, %2, and %3 (%0 is always the name of the batch 
file). To assign numeric or text values, to parameters %1 through 
%3 at the time you start the batch file, enter: 


A>FIXIT.BAT DATE 35 BUDGET 


The FIXIT.BAT entry on the command line is the name of the 
batch processing file. The next entry, DATE is the value you 
want to assign to parameter %1. The third entry 35 is the value 
for parameter %2, and BUDGET is the %3 parameter. 


This way, a batch processing file can immediately perform a task 
for you without having to be specially edited to match your current 
needs. 
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ECHO 


The ECHO command lets you choose whether or not to have the 
commands in your batch file displayed on your screen as each 
command is performed. 


SYNTAX 


COMMENTS 


ECHO [ON |OFF! <message>] 


Commands in a batch file are normally 
displayed as they are performed by your 
computer. If you enter ECHO OFF into a 
batch file the commands are not displayed as 
they are performed. ECHO ON causes the 
commands to be displayed when they are 
performed. 


If neither ON or OFF is specified, entering 
ECHO displays the current setting on your 
screen. 


If ECHO is set to OFF, you can use ECHO 
<message> to display text on your screen. 
This is only used in a batch processing file. 
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FOR 


The FOR command is used to expand the power of a batch or 
interactive command. 


SYNTAX 


COMMENTS 


Batch processing: 
FOR %%<c> IN <set> DO <command> 
Interactive processing: 


FOR %<c> IN <set> DO <command> 


% % <c> is a variable parameter. <c> can be 
any character except 0,1,2,3...,.9. This avoids 
confusion with the %0-%9 batch parameters. 


<set> is a list of items separated by spaces and 
enclosed in parentheses. For example: 


(iteml item2 item3 ... itemN) 


is a <set>. 
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EXAMPLES 


The % %<c> variable is set sequentially to 
each member of <set>, and then <command> 
is performed. If a member of <set> is an 
expression involving either * or ?, or both; then 
the variable is set to each matching pattern 
from the file. In this case, only one such 
<item> may be in the set. Any <item> other 
than the first <item> is ignored. 


FOR %%f IN (*.ASM ) DO MASM % %f; 


FOR %%fIN (BAK ART BUDGT) DO 
REM %%f 


The ‘% %’ is needed so that after batch 
parameter (%0-%9) processing is complete, a 
‘%’ remains. If only ‘%f’ was entered, the 
MS-DOS batch parameter processor sees the 
first ‘%’, looks at ‘f’, decides that ‘%f’ is a bad 
parameter reference, and discards the ‘%f’. 
The FOR command would never receive this 
parameter. In a batch file, you must use the 
expression ‘% %’. 


If you are in interactive MS-DOS processing 
mode, only one ‘%’ is needed. 
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You cannot nest FOR commands in MS-DOS 
like a FOR-NEXT command is used in 
GWBASIC. If you try to do this, the message: 


FOR cannot be nested 


appears when you are running your batch 
program. The program will not perform as you 
expected. 
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GOTO 


The GOTO command is a batch file-only command used to direct 
your program to perform the command following the item 
described in the command modifier. 


SYNTAX GOTO <label> 


COMMENTS A <label> must be included in the GOTO 
command entry. <label> is the place in your 
batch file that you want the program to jump 
to, then perform the commands that follow 
that command. 
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For example: 


spot 
REM This is a loop 
GOTO spot 


causes an infinite sequence of messages to be 
displayed: 


>REM This is a loop 
A>GOTO spot 
A>REM This is a loop 
A>GOTO spot 
A>REM This is a loop 


etcetera 


If you do not include <label> in the GOTO 
command, the batch processing file stops. 


Any line in a batch processing file that begins 
with ‘’ is ignored. 
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IF 


The IF command allows conditional processing of MS-DOS 


commands. 


SYNTAX 


COMMENTS 


IF <condition> <command> 


When <condition> is true, the MS-DOS 
<command> is performed. 


When <condition> is not true, the <command> 
is ignored and the next line in the batch 
processing file is performed. 


<condition> must be the following: 
ERRORLEVEL <number> 

is true if and only if the previous program 
executed by COMMAND had an exit code of 
<number> or higher. 

<string1> == <string2> 

is true if and only if <stringl> and <string2> 
are identical after parameter substitution. 


Strings may not contain any punctuation marks 
that MS-DOS uses for other purposes. 
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EXAMPLES 


EXIST <filename> 
is true if and only if <filename> exists. 
NOT <condition> 


is true if and only if <condition> is false. 


IF NOT EXIST FOO ECHO Can't find file 


IF NOT ERRORLEVEL 3 LINK $1,,; 


Batch Processing Commands 


PAUSE 
toe eee 


The PAUSE command lets you stop the batch processing until 
some action has happened. 


SYNTAX PAUSE [comment] 


COMMENTS Use the PAUSE command to suspend 
processing of a batch file. For example, you 
may want to change diskettes. A PAUSE 
command stops your program to allow you to 
do so. 


When the command processor encounters 
PAUSE, it displays: 


Strike a key when ready... 


If you press (TRC or GertocK), this 


prompt appears: 


Abort batch job (Y/N)? 
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Type Y to stop the batch file and return to 
MS-DOS command level. You can use the 
PAUSE command to segment a batch file into 
segments that can be stopped at any 
appropriate point. 


<comment> is optional and should be entered 
on the same line as PAUSE. <comment> is 
used to prompt — with a meaningful message 
— the batch file user to take some action when 
the file pauses. 


The <comment> is displayed before the 
following message: 


Strike a key when ready... 
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REM 


The REM command lets you see any text that is on the same line 
as the REM command when a batch processing file is being run. 


SYNTAX REM [comment] 


COMMENTS Use only the space, tab, and comma characters 
in the text of a REM comment. Other 
punctuation may be interpreted as a drive 
specifier or part of an MS-DOS command. 


EXAMPLE REM This file checks new diskettes 
REM It is named NEWDISK.BAT 
PAUSE Insert new diskette in drive B 
FORMAT B:/S 
DIR B: 
CHKDSK B: 
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SHIFT 


The SHIFT command lets your batch file access more than 10 
replaceable parameters or variables. 


SYNTAX 


COMMENTS 


SHIFT 


MS-DOS allows 10 parameters (%0-%9) to be 
used by a batch file. SHIFT lets you move 
more parameters into a queue, discarding the 
first parameter. 


Additional parameters (more than ten) should 
be on the same command line in order to be 
shifted into the queue. 


The SHIFT command works like this: 


if %0 = ‘‘bak’’ 
%l = ‘‘art’’ 

%2 = ‘‘budgt’’ 
%3...%9 are empty 


then a SHIFT results in the following: 


%0 = ‘‘bak’? 
%1 = ‘‘budgt’’ 
%2...%9 are empty 


The %0 parameter is always the name of the 
current batch processing file and is not affected 
by a SHIFT command. 
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If there are more than 10 parameters given on 
a command line, those appearing after the 10th 
(%9) are shifted one at a time into %9 by 
successive shifts. 
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Messages 


This appendix contains an alphabetical listing of the messages that 
MS-DOS displays when it is unable to perform a requested task. 


Most of the messages you may encounter when using MS-DOS 
refer to problems in reading from or writing to devices such as 
disk drives or printers. These messages are called device errors. 


Another form of message appears as a result of problems with a 
diskette or disk drive. These are called disk errors. 


Other messages that you may encounter from time to time are 
related to the specific command or task that you are trying to 
perform. Included in the following list of messages is the name of 
the command associated with the displayed message. 
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Device Errors 


All device error messages take the same form. They are displayed 


as: 


<type> error reading/writing <device> 
Abort, Retry, Ignore?_ 


Where <type> represents one of the following: 


Bad call format 
Bad command 
Bad unit 

Data 

Disk 

No paper 
Non-MS-DOS disk 
Not ready 

Read fault 
Sector not found 
Seek 

Write fault 
Write protect 


When you receive one of these messages, you have the choice of 
doing one of the following: 


Enter A for abort. This ends the program that requested the 
read or write. 


Enter R for Retry. This causes your computer to reattempt 
the operation. Correct the problem that caused this message, 
if you can, and press R for Retry. 
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e@ Enter I for Ignore. This causes your computer to ignore the 
problem and attempt to continue the program. If you choose 
this option, you may lose some data. Be careful. 


These device error messages are described along with the rest of 
the error messages in the following list of MS-DOS messages. 


Messages 


Disk Errors 
ne 


If a disk read or write error occurs at any time during a command 
process or when you are running an application program, MS-DOS 
displays an error message in the following format: 


<yyy> ERROR WHILE <I/O action> ON DRIVE x 
Abort, Ignore, Retry: 


In this format, <yyy> may be one of the following: 


WRITE PROTECT 
BAD UNIT 

NOT READY 

BAD COMMAND 
DATA 

BAD CALL FORMAT 
SEEK 

NON-MS-DOS DISK 
SECTOR NOT FOUND 
NO PAPER 

WRITE FAULT 
READ FAULT 

DISK 


<I/O action> is either READING or WRITING 
The drive designation <x> is the drive where the problem 
occurred. 


Enter either A, I, or R as noted previously in order to proceed 
with your choice of action. 
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Allocation error, size adjusted (CHKDSK) 

The file allocation table contains an invalid sector number. The 
file is truncated at the end of the last valid sector. CHKDSK has 
automatically performed the only remedy available at this point. 


Bad call format error (device error) 
A request header of incorrect length was passed to a device driver. 
Contact your dealer for more information. 


Bad command error (device error) 
A device driver has issued an invalid command to the named 
device. Contact your dealer for more information. 


Bad unit error (device error) 
An invalid subunit number has been sent to a device driver. 
Contact your dealer for more information. 


Cannot CHDIR to root 

Processing cannot continue (CHKDSK) 

The disk you are checking is faulty. Restart MS-DOS and try to 
RECOVER the disk. 


Cannot do binary reads from a device (COPY) 
You have tried to use the /B option with the name of a device. 
Place an /A option after the device name to copy in ASCII mode. 


Cannot edit .BAK file - rename file (EDLIN) 

You have tried to edit a file that has a BAK extension. Either 
edit instead the more up to date version of the file, or rename the 
-BAK file before attempting to edit it. 


Data error (device error) 
Data could not be read/written correctly because of a faulty disk. 
Restart MS-DOS and try to RECOVER the disk. 


AG 


Messages 


Disk error (device error) 
An error has occurred reading from or writing to a disk. Attempt 
to correct the problem and reattempt this operation. 


Disk error writing FAT (CHKDSK) 

An error occurred while CHKDSK was trying to update the file 
allocation table. Copy the diskette and reattempt the procedure. 
If this does not work, try to RECOVER the disk. If this does not 
work, the diskette is irreparably damaged. 


Disk full - file write not completed (EDLIN) 

The diskette you are using does not have enough space to save all 
of the file. Part of the file may have been saved on the diskette, 
but the remainder that has not been saved is lost. This is an 
unrecoverable error. Repeat your edit using a diskette with 
sufficient storage space. 


Drive not ready (PRINT) 

If this message appears while PRINT attempts a disk access, 
PRINT keeps trying until the drive is ready. Any other error 
cancels the current file. In this case, an error message is printed 
on your printer. 


Duplicate file name or file not found (RENAME) 

An attempt has been made to rename a file with a filename that 
already exists on the destination disk, or the file to be renamed 
could not be found on the specified disk drive. 


Entry error (EDLIN) 
You have incorrectly entered an EDLIN command. Reenter the 


command. 
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File cannot be copied into itself (COPY) 

A request was made to COPY a file and place the copy (with the 
same name) in the same directory as the source file. Either 
change the name given to the copy or put it on another diskette or 
directory. 


File creation error (MS-DOS and commands) 
An unsuccessful attempt was made to add a new file to the 
directory. Run CHKDSK to determine the cause of the error. 


Filename is cross linked on cluster (CHKDSK) 
You have two files cross linked. Make a copy of the file you want 
to keep, and then delete both files that are cross linked. 


Filename must be specified ((EDLIN) 
You did not specify a filename when you started EDLIN. Specify a 
filename. 


File not found (EDLIN) 
The file you named in the Transfer command does not exist. 
Check your file name selection and try again. 


File not found (MS-DOS and commands) 

The file named in a command does not exist on the disk in the 
specified drive. Check your filename entry or drive selection and 
try again. 


FIND: File not found <filename> (FIND) 
The file you specified does not exist on the drive. Check your 
filename entry or drive selection and try again. 


FIND: Invalid number of parameters (FIND) 
A string was omitted when specifying a FIND command. Reenter 
the command with the search string. 
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FIND: Invalid parameter <option-name> (FIND) 
An invalid parameter was entered with the FIND command. 
Reenter the command with a valid parameter. 


FIND: Read error in <filename> (FIND) 

An error occurred when FIND tried to read the file specified in the 
command. Reattempt the command after correcting an obvious 
problem (disk drive door open, no disk, etc.) Try to RECOVER the 
file. 


FIND: Syntax error (FIND) 
You entered an illegal string with the FIND command. Reenter 
the correct string. 


First cluster number is invalid, entry truncated (CHKDSK) 
An invalid pointer to the data area has been found in the file 
whose name precedes this message. If /F was specified, the file is 
truncated to zero length. This is an irrecoverable error. 


Fixups needed-base segment (hex): (EXE2BIN) 

The source (.EXE) file contained information indicating that a load 
segment is required for the file. Specify the absolute segment 
address at which the finished module is to be located. 


Incompatible system size (SYS) 

The hidden files IBMBIO.COM and IBMDOS.COM do not take up 
the same amount of space on the target diskette as the new system 
needs. Use the same version of MS-DOS to move these files. 


Insufficient disk space (MS-DOS and commands) 

There is not enough free space on the diskette to save the file or 
perform the MS-DOS operation. Use another diskette. You may 
have lost some data as a result of the operation that caused this 


message to appear. 
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Insufficient room in root directory 

Erase files in root and repeat CHKDSK 

CHKDSK cannot create an entry in the root directory for saving 
lost chains as files (see message “X lost clusters found in Y 
chains/ Convert lost chains to files (Y/N?” because the root 
directory is full. You should copy some files from the root 
directory to another disk, then enter another CHKDSK command. 


Invalid current directory 

Processing cannot continue (CHKDSK) 

CHKDSK has found an error in the disk’s current directory. 
Restart your computer and rerun CHKDSK. 


Invalid date (DATE) 
You have tried to enter an invalid date. Review the DATE 
command parameters in Chapter 5 and reenter the date. 


Invalid drive name or file (EDLIN) 
You did not specify a valid drive or filename when you started 
EDLIN. Check your entry and try again. 


Invalid drive specification (MS-DOS and commands) 
You have entered an invalid drive specifier in a command. Check 
your entry and try again. 


Invalid number of parameters (commands) 

You have entered the wrong number of parameters on the 
command line. Refer to the syntax of the command you have 
selected and try again. 


Invalid parameter (commands) 
You have entered an incorrect parameter. Refer to the syntax of 


the command you have selected and try again. 
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Invalid subdirectory (CHKDSK) 
The subdirectory contains invalid information. Rerun the 
CHKDSK command with the /V option for further information. 


Invalid time (TIME) 
You have entered an invalid time or the wrong punctuation mark. 
Refer to the TIME command syntax and try again. 


Line too long (EDLIN) 

During the (R)eplace command operation, the string given as the 
replacement caused the line to expand beyond the 253-character 

limit. The (R)eplace command has not been properly performed. 
Break the long line into shorter lines and try again. 


List output is not assigned to a device (PRINT) 
You have specified an invalid device. Specify a valid list device. 


Must specify destination number (EDLIN) 
You have not specified a destination number for a COPY or MOVE 
command. Enter a destination number and try again. 


No files match <filename> (PRINT) 

You have entered a file specification for files to add to the print 
queue, but no files match your entry. Check your filenames and 
try again. 


Note: If there are no files in the print queue, a message 
does not appear. 
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Non MS-DOS disk error (device error) 

The file allocation table on the diskette contains invalid 
information. If you have inserted the correct diskette, it must be 
reFORMATted. Attempt to copy important files from this diskette 
to another before you FORMAT this diskette. 


No paper error (device error) 
Your printer is not powered ON or it is out of paper. Check your 
printer and try again. 


No room for system on destination disk (SYS) 

There is not enough room on the target diskette for the 
IBMBIO.COM and IBMDOS.COM files. You are using different 
versions of MS-DOS. Use the same version for this operation. 


No room in directory for file (EDLIN) 

The directory of the specified disk is already full, or the specified 
disk drive or file name is illegal. Use another diskette or check 
your entry and try again. 


Not enough room to merge the entire file (EDLIN) 

There is not enough room in your computer’s memory to enable a 
Transfer command to merge the entire contents of the files. Break 
the files into smaller files and try again. 


Not ready error (device error) 
The device you've selected is not ready for the read/write 
operation you've requested. Check the device and try again. 


Out of environment space 
You have attempted to access the PATH command from 
GWBASIC. This is not allowed. 
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PRINT queue is empty (PRINT) 
There are no files in the print queue. Files must be placed in the 
print queue before they can be printed. 


PRINT queue is full (PRINT) 
You cannot place more than ten files in a print queue. 


Probable non-MS-DOS disk 

Continue (Y/N)? (CHKDSK) 

The disk you are using is a non-MS-DOS System diskette. Indicate 
whether or not you want CHKDSK to continue. 


Read fault error (device error) 
MS-DOS cannot read the requested data from the named device. 
Check your entry and try again. 


Read error in <filename> (commands) 
The command you've entered could not read the entire file. Try 
again. If the problem persists, try to RECOVER the file. 


Sector not found error (device error) 

The sector containing the requested data cannot be found or 
cannot be read. This is usually due to a bad sector on the diskette 
or disk. Try to RECOVER the diskette. If this does not solve the 
problem, the data is lost. 


Seek error (device error) 

The diskette drive cannot find the proper track on the diskette. 
Try again. If the problem persists, the diskette is probably 
damaged and cannot be recovered. 


Unrecoverable error in directory 

Convert directory to file (Y/N)? (CHKDSK) 

To convert the problem directory to a file, press Y. You can then 
repair or delete the directory at a later time. 


A-13 


Messages 


Write fault error (device error) 
MS-DOS cannot successfully write data from or to the named 
device. Check your entry and try again. 


Write protect error (device error) 

You have tried to write data onto a diskette that is write- 
protected. Check the diskette to be sure that you want to write to 
or change information on this diskette. 


X lost cluster found in y chains 

Convert lost chains to files (Y/N)? 

CHKDSK has found lost clusters on your diskette. These may be 
parts of data files that have somehow been separated from their 
original files. If you press Y, these clusters are written into files 
that are placed in the root directory under the name(s) 
FILEnnnnnn. You can then attempt to repair damaged files or 
delete these safety files. 


CHKDSK then displays: 
X bytes disk space freed 


If you select N and have not specified the /F option of CHKDSK, 
the clusters are freed (deleted), and the message: 


X bytes disk space would be freed 


appears on your screen. 
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Introduction 
a 


This appendix is a function and command reference to the EDLIN 
program on your MS-DOS System diskette. EDLIN is provided for 
use by persons with prior experience in programming computers. 
EDLIN is not intended for novice users. If you are new to using 
computers, you will find that a dedicated word processing program 
may be easier to use. The information in this appendix does not 
include a tutorial for use by beginners. 


If you are an experienced computer user you may choose to use 
EDLIN to create, change, and display files, whether they are 
source program or text files. 


You can use EDLIN to: 

@ Create new source files and save them 

@ Update existing files and save both the updated and original 
@ Delete, edit, insert, and display lines 


@ Search for, delete, or replace text within one or more lines. 


The text in files created or edited by EDLIN is divided into lines, 
each up to 253 characters long. Line numbers are generated and 
displayed by EDLIN during the editing process, but are not 
actually present in the saved file. 


When you insert lines, all line numbers following the inserted text 
advance automatically by the number of lines being inserted. 


When you delete lines in a file, all line numbers following the 
deleted text decrease automatically by the number of lines deleted. 
As a result, lines are always numbered consecutively in your file. 
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Command Information 


EDLIN commands perform editing functions on lines of text. The 


following list contains information you should read before you use 
EDLIN commands. 


] Pathnames are acceptable as options to commands. 


For example, typing EDLIN \BIN\USER\JOE\TEXT.TXT 
allows you to edit the TEXT.TXT file in the subdirectory \JOE. 


Q You can reference line numbers relative to the current line 
(the line with the asterisk). Use a minus sign with a number 
to indicate lines before the current line. Use a plus sign with a 
number to indicate lines after the current line. 


Example: 


-10,+10L 


This command lists 10 lines before the current line, the current 
line, and 10 lines after the current line. 


3 Multiple commands may be issued on one command line. When 
you issue a command to edit a single line using a line number 
(<line>), a semicolon must separate commands on the line. 
Otherwise, one command may follow another without any 
special separators. In the case of a Search or Replace 
command, the <string> may be ended by a instead of a 


(RETURN). 


EDLIN - The Line Editor 


Examples: 


The following command line edits line 15 and then displays 
lines 10 through 20 on the screen. 


15;-5,+5L 


The command line in the next example searches for “This 
string” and then displays 5 lines before and 5 lines after the 
line containing the matched string. If the search fails, then 
the displayed lines are those line numbers relative to the 
current line. 


This string CTRL Z -5,+5L 


You can type EDLIN commands with or without a space 
between the line number and command. 


For example, to delete line 6, the command 6D is the same as 
6D. 


It is possible to insert a control character (such as (CtriJC) into 
text by using the quote character (ErRV before the capital 
letter associated with it while in insert mode. (crrV tells 
MS-DOS to recognize the next capital letter typed as a control 
character. It is also possible to use a control character in any 
of the string arguments of Search or Replace by using the 
special quote character. For example: 


S CTRL V Z 


finds the first occurrence of (cTR)Z in a file. 


B-6 


EDLIN - The Line Editor 


R CTRL V Z CTRL Z foo 
replaces all occurrences of (rRU)Z in a file by foo 


S CTRL V C CTRL Z bar 


replaces all occurrences of (€tri)C by bar. 


It is possible to insert (ErR)V into the text by typing 
JV V. 


Z character ordinarily tells EDLIN, “This is the end 
of the file.” If you have (€RZ characters elsewhere in your 
file, you must tell EDLIN that these other control characters 
do not mean end-of-file. Use the /B option to tell EDLIN to 
ignore any Z characters in the file and to show you the 
entire file. 
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EDLIN Commands 


The EDLIN commands are summarized in the following table. 
They are also described in further detail following the description 
of command options. 


Command Purpose 


<line> Edits line no. 
Appends lines 
Copies lines 
Deletes lines 
Ends editing 
Inserts lines 
Lists text 
Moves lines 
Pages text 
Quits editing 
Replaces lines 
Searches text 
Transfers text 
Writes lines 
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How To Start EDLIN 


To start EDLIN, type: 
EDLIN <filename> 


If you are creating a new file, the <filename> should be the name 
of the file you wish to create. If EDLIN does not find this file on a 
drive, EDLIN creates a new file with the name you specify. The 
following message and prompt are displayed: 


New file 


Notice that the prompt for EDLIN is an asterisk (*). 


You can now type lines of text into your new file. To begin 
entering text, you must enter an I (Insert) command to insert 
lines. The I command is discussed later in this chapter. 


If you want to edit an existing file, <filename> should be the 
name of the file you want to edit. When EDLIN finds the file you 
specify on the designated or default drive, the file is loaded into 
memory. 


If the entire file can be loaded, EDLIN displays the following 
message on your screen: 


End of input file 


You can then edit the file using EDLIN editing commands. If the 
file is too large to be loaded into memory, EDLIN loads lines until 
memory is 3/4 full, then displays the * prompt. You can then edit 
the portion of the file that is in memory. 
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To edit the remainder of the file, you must save some of the edited 
lines on disk to free memory; then EDLIN can load the unedited 
lines from disk into memory. Refer to the Write and Append 
commands in this Appendix for more information. 


When you complete the editing session, you can save the original 
and the updated (new) files by using the End command. The End 
command is discussed in this chapter in the section EDLIN 
Commands. The original file is renamed with an extension of 
-BAK, and the new file has the filename and extension you specify 
in the EDLIN command. 


The original .BAK file is not erased until the end of the editing 
session, or until disk space is needed by the editor (EDLIN). 


Do not try to edit a file with a filename extension of .BAK because 
EDLIN assumes that any .BAK file is a backup file. 


If you find it necessary to edit such a file, rename the file with 
another extension (using the MS-DOS RENAME command 
discussed in Chapter 5), then start EDLIN and specify the new 
<filename>. 
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Special Editing Keys 


ss 


The table below describes some of the commands, codes, and 
functions that are assigned to the special editing keys. 


The “command line” is the line on your screen where you enter the 
text and EDLIN commands for the line you are editing. A 
“template” is the line you create, in part, from the line you are 


editing. 
FUNCTION KEY 
Copy 1 character Fl 


Copy up to character F2 


Copy template F3 


Skip one character DEL 


Skip up to character F4 


Quit input ESC 
Insert mode INS 
Replace mode INS F3 
New template FS 


DESCRIPTION 


Copies 1 character from the 
template to the new line. 


Copies all characters from the 
template to the new line, up to 
the character specified. 


Copies all remaining 
characters in the template to 
the screen. 


Does not copy (skips over) a 
character. 


Does not copy (skips over) the 
characters in the template, up 
to the character specified. 


Voids the current input; leaves 
the template unchanged. 


Enters/exits insert mode. 


Turns insert mode off; this is 
the default. 


Makes the new line the new 
template. 
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F1 Key 


PURPOSE 


COMMENTS 


EXAMPLE 


Copies one character from the template to the 
command line. 


Pressing the (Fi) key copies one character from 
the template to the command line. When the (i) 
key is pressed, one character is inserted in the 
command line and the insert key is disabled. 


Assume that the screen shows: 


1:*This is a sample file. 


18 


At the beginning of the editing session, the 
cursor (indicated by the underline) is positioned 
at the beginning of the line. Pressing the (Fi) 
key copies the first character (T) to the second 
of the two lines displayed: 


1:*This is a sample file 
a 


Each time the (Fi) key is pressed, one more 
character appears: 


Fa a:*Th 
Fl 424*ThI, 
F1 i:*This_ 
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F2 Key 


PURPOSE 


COMMENTS 


EXAMPLE 


Copies multiple characters up to a given 
character. 


Pressing the (F2) key copies all characters up to 
a given character from the template to the 
command line. The given character is the next 
character typed after (F2), it is not copied or 
displayed on the screen. 


Pressing the (F2) key causes the cursor to move 
to the single character that is specified in the 
command. If the template does not contain the 
specified character, nothing is copied. Pressing 
( also disables the insert key. 


Assume that the screen shows: 


1:*This is a sample file. 


As 


At the beginning of the editing session, the 
cursor (indicated by the underline) is positioned 
at the beginning of the line. 


Pressing the (F2) key copies all characters up to 
the character specified immediately after the 


() key. 


1:*This is a sample file 
F2p 1:*This is a sam_ 
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F3 Key 


PURPOSE 


COMMENTS 


EXAMPLE 


Copies template to command line. 


Pressing the (F3) key copies all remaining 
characters from the template to the command 
line. Regardless of the cursor position at the 
time the (F3) key is pressed, the rest of the line 
appears, and the cursor is positioned after the 
last character on the line. 


The insert key is disabled. 
Assume that the screen shows: 


1:*This is a sample file. 


Ms 


At the beginning of the editing session, the 
cursor (indicated by the underline) is positioned 
at the beginning of the line. 


Pressing the (F3) key copies all characters from 
the template cursor. 


1:*This is a sample file (template) 
F3 1:*This is a sample file.__Ccommand line) 
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DEL Key 


PURPOSE 


COMMENTS 


EXAMPLE 


Skips over one character in the template. 


Pressing the key skips over one character 
in the template. Each time you press the 
key, one character is not copied from the 
template. The action of the key is similar 
to the (Fi) key, except that skips a 
character in the template rather than copying 
it to the command line. 


Assume that the screen shows: 


1:*This is a sample file. 


ae 


At the beginning of the editing session, the 
cursor (indicated by the underline) is positioned 
at the beginning of the line. Pressing the 
key skips over the first character (T): 


1:*This is a sample file 
DEL 1:*_ 
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The cursor position does not change and only 
the template is affected. To see how much of 
the line has been skipped over, press the (F3) 
key, to move the cursor beyond the last 
character of the line. 


1:*This is a sample file. 
DEL 1:*_ 


F3 1:*his 1s a sample file._ 
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F4 Key 


PURPOSE 


COMMENTS 


EXAMPLE 


Skips multiple characters in the template up to 
the specified character. 


Pressing the key skips over all characters 
up to a given character in the template. This 
character is not copied and is not shown on the 
screen. If the template does not contain the 
specified character, nothing is skipped over. 


The action of the key is similar to the (F2) 
key, except that (Fa) skips over characters in 
the template rather than copying them to the 
command line. 


Assume that the screen shows: 


1:*This is a sample file. 


tet 


At the beginning of the editing session, the 
cursor (indicated by the underline) is positioned 
at the beginning of the line. Pressing the 
key skips over all the characters in the 
template up to the character pressed after the 


key: 


1:*This 1s a sample file 


F4p ist 
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The cursor position does not change. To see 
how much of the line has been skipped over, 
press the (F3) key to copy the template. This 


moves the cursor beyond the last character of 
the line: 


1:*This is a sample file: 
F4pF3 1:*ple file. 
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ESC Key 


PURPOSE 


COMMENTS 


EXAMPLE 


Quits input and empties the command line. 


Pressing the (Esc) key empties the command 
line, but it leaves the template unchanged. (Esc) 
also prints a backslash (\), carriage return, line 
feed, and turns insert mode off. The cursor 
(indicated by the underline) is positioned at the 
beginning of the line. Pressing the (F3) key 
copies the template to the command line and 
the command line is identical to the original 
template. 


Assume that the screen shows: 


1:*This is a sample file. 


At the beginning of the editing session, the 
cursor (indicated by the underline) is positioned 
at the beginning of the line. Assume that you 
want to replace the line with “Sample File:” 


1:*This is a sample file. 
1:*Sample File:_ 
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To cancel the line you just entered (Sample 
File), and to keep “This is a sample file.”, press 
. Notice that a backslash appears on the 
Sample File line to tell you it has been 
canceled. 


1:*This is a sample file. 
ESC 1:*Sample File \ 
12, 


Press to keep the original line, or to 
perform any other editing functions. If (F3) is 
pressed, the original template is copied to the 
command line: 


F3 1: This is a sample file._ 
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INS Key 


PURPOSE 


COMMENTS 


EXAMPLE 


Enters/exits insert mode. 


Pressing the (INs) key causes EDLIN to enter or 
exit insert mode. The current cursor position in 
the template is not changed. The cursor moves 
as each character is inserted. However, when 
you have finished inserting characters, the 
cursor is positioned at the same character as it 
was before the insertion began. Thus, 
characters are inserted in front of the 
character that the cursor points to. 


Assume that the screen shows: 


1:*This is a sample file. 


at 


At the beginning of the editing session, the 
cursor (indicated by the underline) is positioned 
at the beginning of the line. Assume that you 
press the (F2) and f keys: 


t:*This is a sample file 
Ff 1:*This is a sample _ 
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Now press the (INS) key and insert the 
characters “edit” and a space: 


1:*This is a sample file. 
F2f 1:*This is a sample _ 
INSedit 1:*This is a sample edit _ 


If you now press the (F3) key, the rest of the 
template is copied to the line: 


1:*This is a sample edit 


F3 1:*This is a sample edit file._ 


If you press the remainder of the 
template would be truncated, and the command 
line would end at the end of the insert: 


INSedit RETURN 1:*This is a sample edit _ 


To exit insert mode, simply press the (INs) key 
again. 
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INS F3 Key 


PURPOSE 


COMMENTS 


EXAMPLE 


Enters replace mode. 


Pressing the (INS) and (F3) keys simultaneously 
causes EDLIN to exit insert mode and enter 
replace mode. 


All the characters you type replace characters 
in the template. When you start to edit a line, 
replace mode is in effect. 


If (RETURN) is pressed, the remainder of the 
template is deleted. 


Assume that the screen shows: 


This is a sample file. 


At the beginning of the editing session, the 
cursor (indicated by the underline) is positioned 
at the beginning of the line. 


Assume that you then press (F2)m, (insjlary, 
(Ns) (3) tax, and then (F3): 


1:*This is a sample file. 

Fam 1:*This is a sa_ 

INSlary 1:*This is a salary 

INS F3 tax 1:*This is a salary tax_ 
F3 1:*This is a salary tax file._ 
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Notice that you inserted lary and replaced 
mple with tax. If characters on the command 
line extend beyond the length of the template, 
the remaining characters in the template are 
automatically appended when you press (F3). 
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F5 Key 


PURPOSE 


COMMENTS 


EXAMPLE 


Creates a new template. 


Pressing the (Fs) key copies the current 
command line to the template. The contents of 
the old template are deleted. Pressing (F5) 
outputs an @ (“at sign” character), a carriage 
return, and a line feed. The command line is 
also emptied and insert mode is turned off. 


Note: (Fs) performs the same function 
as the (Esc) key, except that the 
template is changed and an @ (“at 
sign” character) is printed instead of 
a\. 


Assume that the screen shows: 


1:*This is a sample file. 


12% 


At the beginning of the editing session, the 
cursor (indicated by the underline) is positioned 
at the beginning of the line. 
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Assume that you enter (F2)m, (INsJlary, (ins) (F3. 
tax, and then (F3): 


1:*This is a sample file. 

Fam 1:*This is a sa_ 

INSlary 1:*This is @ salary 

INS F3 tax 1:*This is @ salary tax_ 
F3 1:*This ts a salary tax file._ 


At this point, assume that you want this line to 
be the new template, so you press the (Fs) key: 


FS1:*This is a salary tax file.g 


The @ indicates that this new line is now the 
new template. Additional editing can be done 
using the new template. 
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Command Options 


Several EDLIN commands accept one or more options. The effect 
of a command option varies, depending on which command it is 
used with. The following list describes each option. 


<line> 


Number 


Period (.) 


Pound (#) 


<line> indicates a line number that you type. 
Line numbers must be separated by a comma 
or a space from other line numbers, other 
options, and from the command. 


<line> may be specified one of three ways: 


Any number less than 65534. If a number 
larger than the largest existing line number is 
specified, then <line> means the line after the 
last line number. 


If a period is specified for <line>, then <line> 
means the current line number. The current 
line is the last line edited, and is not 
necessarily the last line displayed. The current 
line is marked on your screen by an asterisk (*) 
between the line number and the first 
character. 


The pound sign indicates the line after the last 
line number. If you specify # for <line>, this 
has the same effect as specifying a number 
larger than the last line number. 
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a 


RETURN 


<string> 


A carriage return entered without any of the 
<line> specifiers listed above directs EDLIN to 
use a default value appropriate to the 
command. 


The question mark option directs EDLIN to ask 
you if the correct string has been found. The 
question mark is used only with the Replace 
and Search commands. Before continuing, 
EDLIN waits for either a Y or for a yes 
response, or for any other key for a no 
response. 


<string> represents text to be found, to be 
replaced, or to replace other text. The 
<string> option is used only with the Search 
and Replace commands. Each <string> must be 
ended by a (RETURN) (see the Replace 
command for details). No spaces should be left 
between strings or between a string and its 
command letter, unless you want those spaces 
to be part of the string. 
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(A)ppend 


PURPOSE 


SYNTAX 


COMMENTS 


Adds the specified number of lines from disk to 
the file being edited in memory. The lines are 
added at the end of lines that are currently in 
memory. 


[njJA 


This command is meaningful only if the file 
being edited is too large to fit into memory. As 
many lines as possible are read into memory 
for editing when you start EDLIN. 


To edit the remainder of the file that does not 
fit into memory, lines that have already been 
edited must be written to disk. Then you can 
load unedited lines from disk into memory with 
the Append command. 


Refer to the Write command in this chapter for 
information on how to write edited lines to 
disk. 


Note 1: If you do not specify the 
number of lines to append, lines are 
appended to memory until available 
memory is 3/4 full. No action is taken if 
available memory is already 3/4 full. 


Note 2: The message “End of input 
file” is displayed when the Append 
command has read the last line of the 
file into memory. 
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(C)opy 


eH 


PURPOSE 


SYNTAX 


COMMENTS 


EXAMPLES 


Copies a range of lines to a specified line 
number. The lines can be copied as many times 
as you want by using the <count> option. 


[line}/line},<line>{,count|C 


If you do not specify a number in <count>, 
EDLIN copies the lines one time. If the first or 
the second line are omitted, the default is the 
current line. The file is renumbered 
automatically after the copy. 


The line numbers must not overlap or an 
“Entry error” message appears. For example, 
3,20,15C would result in an error message. 


Assume that the following file exists and is 
ready to edit: 


This is a sample file 
used to show copying lines. 
See what happens when you use 
the Copy command 

(the C command) 


ONnawn oe 


to copy text in your file. 


You can copy this entire block of text by 
issuing the following command: 


1,6,7C 
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This is a sample file 
used to show copying lines. 
See what happens when you use 
the Copy command 

(the © command) 

to copy text in your file. 
This is a sample file 

used to show copying lines. 
See what happens when you use 
the Copy command 

(the © command) 

to copy text in your file. 


If you want to place the text within other text, 
the third <line> option should specify the line 
before which you want the copied text to 
appear. For example, assume that you want to 
copy lines and insert them within the 
following file: 


10: 


This is a sample file 
used to show copying lines. 
See what happens when you use 
the Copy command 

(the C command) 

to copy text in your file. 
You can also use COPY 

to copy lines of text 

to the middle of your file. 
End of sample file. 
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The command 3,6,10C results in the following 


file: 

1: This is a sample file 

2: used to show copying lines. 
3: See what happens when you use 
4: the Copy command 

S: (the C command) 

6: to copy text in your file. 

7: You can also use COPY 

8: to copy lines of text 

9: to the middle of your file. 
10: See what happens when you use 
11: the Copy command 

12: (the C command) 

13: to copy text in your file. 
14: End of sample file. 
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(D)elete 


-__ ere 


PURPOSE 


SYNTAX 


COMMENTS 


EXAMPLES 


Deletes a specified range of lines in a file. 
{line],line}D 


If the first <line> is omitted, that option 
defaults to the current line (the line with the 
asterisk next to the line number). If the second 
<line> is omitted, then just the first <line> is 
deleted. When lines have been deleted, the line 
immediately after the deleted section becomes 
the current line and has the same line number 
as the first deleted <line> had before the 
deletion occurred. 


Assume that the following file exists and is 
ready to edit: 


This is a sample file 
used to show dynamic line numbers. 


See what happens when you use 


aw no 


Delete and Insert 


2S: (the D and I commands) 
26: to edit the text 
27:*1n your file. 
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B- 


To delete multiple lines, typ 


<line>,<line>D: 
5,24D 


The result is: 


This is a sample file 

used to show dynamic line numbers. 
See what happens when you use 
Delete and Insert 

:*€the D and I commands) 

to edit text 


Vounswns 


in your file. 


To delete a single line, type: 


6D 


The result is: 


1; This is a sample file 
2: used to show dynamic line numbers. 
3: See what happens when you use 

4: Delete and Insert 

S: (the D and I commands) 

G:"in your file. 
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Next, delete a range of lines from the following 
file: 


This is a sample file 
used to show dynamic line numbers. 
:*See what happens when you use 
Delete and Insert 

(the D and I commands) 

to edit text 

in your file. 


Vounsun 


To delete a range of lines beginning with the 
current line, type: 


6D 
The result is: 


1: This is a sample file 


2: used to show dynamic line numbe 


3:tin your file. 


Notice that the lines are automatically 
renumbered. 
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<line> Edit 


SUE EEE EEEEE oo 


PURPOSE Edits line of text. 
SYNTAX {line} 


COMMENTS When a line number is typed, EDLIN displays 
the line number and text; then, on the line 
below, EDLIN reprints the line number. The 
line is now ready for editing. You may use any 
of the EDLIN editing commands to edit the 
line. The existing text of the line serves as the 
template until is pressed. 


Warning: If (RETURN) is pressed 
while the cursor is in the middle of 
the line, the remainder of the line is 
deleted. 


EXAMPLE 
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Assume that the following file exists and is 
ready to edit: 


1: This is a sample file. 
2: used to show 

3: the editing of line 

4 


:* four. 


To edit line 4, type: 


The contents of the line are displayed with a 
cursor below the line: 


4: four. 
4e8 


Now, using the (F3) special editing key, type: 


INSnumber 4: number_ 
F3 RETURN 4: number four. 
5:* 
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(E)nd 


PURPOSE 


SYNTAX 


COMMENTS 


EXAMPLE 


Ends the editing session. 
E 


This command saves the edited file on disk, 
renames the original input file 
<filename>.BAK, and then exits EDLIN. If the 
file was created during the editing session, no 
-BAK file is created. 


The E command takes no options. When you 
begin EDLIN, you must enter the file 
specification for the output file. If the drive is 
not selected when EDLIN is started, the file is 
saved on the disk in the default drive. It is still 
possible to COPY the file to a different drive 
using the MS-DOS COPY command. 


You must be sure that the disk contains enough 
free space for the entire file. If the disk does 
not contain enough free space, the write is 
aborted and the edited file lost, although part 
of the file might be written to the disk. 


E 

After execution of the E command, the 
MS-DOS default drive prompt (for example, 
A>) is displayed. 
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(I)nsert 


PURPOSE 


SYNTAX 


COMMENTS 


Inserts text immediately before the specified 
<line>. 


{line]I 


If you are creating a new file, the I command 
must be given before text can be typed 
(inserted). Text begins with line number 1. 
Successive line numbers appear automatically 


each time (RETURN) is pressed. 


EDLIN remains in insert mode until 
typed. 


When the insert is completed and insert mode 
is finished, the line immediately following the 
inserted lines becomes the current line. All line 
numbers following the inserted section are 
incremented by the number of lines inserted. 


If <line> is not specified, the default is the 
current line number and the lines are inserted 
immediately before the current line. 
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EXAMPLES 


If <line> is any number larger than the last 
line number, or if a pound sign (#) is specified 
as <line>, the inserted lines are appended to 
the end of the file. In this case, the last line 
inserted becomes the current line. 


Assume that the following file exists and is 
ready to edit: 


: This 1s a sample file 
used to show dynamic line numbers. 
3: See what happens when you use 
Delete and Insert 

: (the D and I commands) 

to edit text 

7:*1n your file. 


To insert text before a specific line that is not 
the current line, type <line>I: 


71 


The result is: 
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Now, type the new text for line 7: 
7: and renumber lines 


Then to end the insertion, press (RETURN), then 
press (crri)Z on the next line: 


8: CTRL Z 


Now, type L to list the file. The result is: 


: This is a sample file 

: used to show dynamic line numbers. 
: See what happens when you use 

: Delete and Insert 

(the D and I commands) 

to edit text 


: and renumber lines 


OVYOansawn 


rin your file. 


To insert lines immediately before the current 
line, type: 


The result is: 
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Now, insert the following text and terminate 
with a (€TR)JZ on the next line: 


8: so they are consecutive 
9: CTRL Z 


Now to list the file and see the result, type 
L 
The result is: 


: This ts a sample file 

: used to show dynamic line numbers. 
: See what happens when you use 

: Delete and Insert 


to edit text 
: and renumber lines 


1 
2 

3 

4 

S: the D and 1 commands) 
6 

7 

8: so they are consecutive 
3 


:fin your file. 
To append new lines to the end of the file, type: 
101 


This produces the following: 
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Now, type the following new lines: 


10: The insert command can place new lines 
11: in the file; there’s no problem 
12: because the line numbers are dynamic; 
13: theyll go all the way to 65533. 


End the insertion by pressing (GTRU)Z on line 14. 
The new lines appear at the end of all previous 
lines in the file. Now type the List command, 
L: 


The result is: 


1: This is a sample file 
2: used to show dynamic line numbers. 

3: See what happens when you use 

4: Delete and Insert 

S: (the D and I commands) 

6: to edit text 

7: and renumber lines 

8: so they are consecutive 

9: in your file. 

10: The insert command can place new lines 
11: in the file; there’s no problem 

12: because the line numbers are dynamic; 
13: they’11 go all the way to 65533. 
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(L)ist 
PURPOSE Lists a group of lines, including the two lines 
specified. 
SYNTAX {line],line]L 


COMMENTS Default values are provided if either one or 
both of the options are omitted. If you omit the 
first option, as in: 


,»<line>L 


the display starts 11 lines before the current 
line and ends with the specified <line>. The 
beginning comma is required to indicate the 
omitted first option. 


Note: If the specified <line> is more 
than 11 lines before the current line, 
the display is the same as if you 
omitted both options. If you omit the 
second option, as in 


<line>L 


23 lines are displayed, starting with the 
specified <line>. 
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If you omit both parameters, as in 


23 lines are displayed — the 11 lines before the 
current line, the current line, and the 11 lines 
after the current line. If there are less than 11 
lines before the current line, more than 11 lines 
after the current line are displayed to make a 
total of 23 lines. 


EXAMPLES Assume that the following file exists and is 
ready to edit: 


: This is a sample file 


: used to show dynamic line numbers. 


1 
2 
3: See what happens when you use 
4: Delete and Insert 

s 


: (the D and I commands) 
15:*The current line contains an asterisk. 


26: to edit text 
27: 1n your file. 
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To list a range of lines without reference to the 
current line, type <line>,<line>L: 


2,5L 


The result is: 


: used to show dynamic line numbers. 
: See what happens when you use 


: Delete and Insert 


wawn 


(the D and I commands) 


To list a range of lines beginning with the 
current line, type ,<line> L: 


»26L 
The result is: 


1S:*The current line contains an asterisk. 


26: to edit text 
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To list a range of 23 lines centered around the 
current line, type only L: 


L 


The result is: 


4: Delete and Insert 
S: (the D and I commands) 


3: The current line is listed in the middle 
of the range. 

4: The current line remains unchanged by 
the L command. 


S:*The current line contains an asterisk. 


6: to edit text. 


BT 
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(M)ove 


-_-_-eoeooo 


PURPOSE 


SYNTAX 


COMMENTS 


Moves a range of text to the line specified. 
[line] {line],<line>M 


Use the Move command to move a block of text 
(from the first <line> to the second <line>) to 
another location in the file. 


Text is inserted before the target line. 


The lines are renumbered according to the 
direction of the move. For example, 


,+25,100M 


moves the text from the current line plus 25 
lines to line 100. If the line numbers overlap, 
EDLIN displays an “Entry error” message. 
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(P)age 
PURPOSE Pages through a file 23 lines at a time. 
SYNTAX [line], line]P 


COMMENTS If the first <line> is omitted, that number 
defaults to the current line plus one. If the 
second <line> is omitted, 23 lines are listed. 
The new current line becomes the last line 
displayed and is marked with an asterisk. 
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(Q)uit 


PURPOSE 


SYNTAX 


COMMENTS 


EXAMPLE 


Quits the editing session, does not save any 
editing changes, and exits to the MS-DOS 
operating system. 


Q 


EDLIN prompts you to make sure you don’t 
want to save the changes. 


Type Y if you want to quit the editing session. 


No editing changes are saved and no .BAK file 
is created. Refer to the End command in this 
Appendix for information about the .BAK file. 


Type N or any other character except Y if you 
want to continue the editing session. 


Note: When started, EDLIN erases 
any previous copy of the file with an 
extension of .BAK to make room to 
save the new copy. If you reply Y to 
the Abort edit (Y/N)? message, your 
previous backup copy no longer exists. 


Q 
Abort edit (Y/N)?Y (RETURN 
A>_ 
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(R)eplace 


PURPOSE 


SYNTAX 


COMMENTS 


Replaces all occurrences of a string of text in 
the specified range with a different string of 
text or blanks. 


{line],line]?|R<string1> (Cir)Z <string2> 


As each occurrence of <string1> is found, it is 
replaced by <string2>. Each line in which a 
replacement occurs is displayed. If a line 
contains two or more replacements of 
<stringl> with <string2>, then the line is 
displayed once for each occurrence. 


When all occurrences of <string1> in the 
specified range are replaced by <string2>, the 
R command terminates and the asterisk 
prompt reappears. 


If a second string is to be given as a 
replacement, then <string1> must be separated 
from <string2> with a (rr)Z. <String2> must 
end witha Z (RETURN) combination or with 
a simple (RETURN). 


If <string1> is omitted, then Replace takes the 
old <string1> as its value. If there is no old 
<string]>, i.e., this is the first replace done, 
then the replacement process ends immediately. 
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If the first line is omitted in the range 
argument (as in ,line) then the first line 
defaults to the line after the current line. If the 
second line is omitted (as in line or line,), the 
second line defaults to #. Therefore, 
R<stringl> <string2> is the same as line+1,#. 
Remember that # indicates the line after the 
last line of text. 


If <stringl> is ended with a (Crr)Z and there 
is no <string2>, <string2> is taken as an 
empty string and becomes the new replace 
string. For example, 


R<string2> CTRL Z 
deletes all of <stringl>, but 
R<string1> 
and 
R 


both use the old <string2> and the later 
example also uses the old <stringl>. Note that 
“old” here refers to a previous string specified 
either in a Search or a Replace command. 
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If the question mark (?) option is used, the 
Replace command stops at each line with a 
string that matches <string1>, displays the 
line with <string2> in place, and then displays 
the prompt O.K.?. If you press Y or the (RETURN 
key, then <string2> replaces <stringl>, and 
the next occurrence of <stringl> is found. 


Again, the O.K.? prompt is displayed. This 
process continues until the end of the range or 
until the end of the file. After the last 
occurrence of <stringl> is found, EDLIN 
displays the asterisk prompt. 


If you press any key besides Y or (RETURN) after 
the O.K.? prompt, <string1> is left as it was in 
the line, and Replace goes to the next 
occurrence of <stringl>. If <string1> occurs 
more than once in a line, each occurrence of 
<string> is replaced individually, and the 
O.K.? prompt is displayed after each 
replacement. In this way, only the desired 
<stringl> is replaced, and you can prevent 
unwanted substitutions. 


EDLIN - The Line Editor 


EXAMPLES 
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Assume that the following file exists and is 
ready for editing: 


Swoarvanrwne 


V4: 


This is a sample file 
used to show dynamic line numbers. 
See what happens when you use 

Delete and Insert 

(the D and I commands) 

to edit text 

in your file. 

The insert command can place new lines 
in the file; there’s no problem 
because the line numbers are dynamic; 
they’1l go all the way to 65533. 


To replace all occurrences of <string1> with 
<string2> in a specified range, type: 


2,12 Rand CTRL Z or RETURN 


The result is: 


4: 
S: 


Delete or Insert 
(the D or I commands) 


8: The insert commands can place new lines 
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Note that in the previous replacement, some 
unwanted substitutions have occurred. To avoid 
these and to confirm each replacement, the 
same original file can be used with a slightly 
different command. 


In the next example, to replace only certain 
occurrences of the first <string> with the 
second <string>, type: 


2? Rand CTRL Z or RETURN 
The result is: 


4: Delete or Insert 
O.K.7 ¥ 
S: (The D or I commands) 
0.K.7 
S: (The D or I commands) 
0.K.7.N 
8: The insert command can place new lines 
O.K.7.N 
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Now, type the List command (L) to see the 
result of all these changes: 


4: Delete or Insert 
S: (The D or I commands) 


8: The insert command can place new lines 
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(S)earch 


PURPOSE 


SYNTAX 


COMMENTS 


Searches the specified range of lines for a 
specified string of text. 


[line], line]?|S<string> 


The <string> must be ended with a (RETURN). 
The first line that matches <string> is 
displayed and becomes the current line. If the 
question mark option is not specified, the 
Search command ends when a match is found. 
If no line contains a match for <string>, the 
message “Not found” is displayed. 


If the question mark option (?) is included in 
the command, EDLIN displays the first line 
with a matching string; it then prompts you 
with the message O.K.?. If you press either the 
Y or (RETURN) key, the line becomes the current 
line and the search ends. 


If you press any other key, the search continues 
until another match is found, or until all lines 
have been searched (and the Not found message 
is displayed). 


If the first line is omitted (as in ,line 
S<string>), the first line defaults to the line 
after the current line. If the second line is 
omitted (as in line S<string> or line, 
S<string>), the second line defaults to # (line 
after last line of file). 


This is the same as typing line, #S <string>. 
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EXAMPLES 


If <string> is omitted, Search takes the old 
string if there is one. (Note that “uld” here 
refers to a string specified in a previous Search 
or Replace command.) If there is not an old 
string (i.e., no previous search or replace has 
been done), the command ends immediately. 


Assume that the following file exists and is 
ready for editing: 


: This is a sample file 
: used to show dynamic line numbers. 
See what happens when you use 

: Delete and Insert 

: (the D and I commands) 

to edit text 

in your file. 


DvYHOHHZWHH 


: The insert command can place new lines 
9: in the file; there’s no problem 
10: because the line numbers are dynamic; 
11:*they’ll go all the way to 65533. 


To search for the first occurrence of the string 
“and”, type: 


1,12 Sand 
The following line is displayed: 


4: Delete and Insert 
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To get the “and” in line 5, modify the search 
command by typing: 


DEL F3,12 Sand 


The search then continues from the line after 
the current line (line 4), since no first line was 
given. The result is: 


5: (the D and I commands) 


To search through several occurrences of a 
string until the correct string is found, type: 


1,? Sand 
The result is: 


4: Delete and Insert 
O.K.7 
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If you press any key (except Y or (RETURN), the 
search continues, so type N here: 


O.K.7.N 
Continue: 


S: (the D and I commands) 
O.K.7 


Now, press Y to terminate the search: 
0.K.7 Y 
To search for string XYZ from the line after 


the current line to the end without the 
verification (O.K.?), type: 


SXYZ 


EDLIN reports a match and continues to 
search for the same string when you issue the 
S command: 


Ss 
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(T)ransfer 


PURPOSE Inserts (merges) the contents of <filename> 
into the file currently being edited at line. If 
line is omitted, then the current line is used. 


SYNTAX {line]T<filename> 


COMMENTS This command is useful if you want to put the 
contents of a file into another file or into the 
text you are typing. The transferred text is 
inserted at the line number specified by <line> 
and the lines are renumbered. 
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(W)rite 


PURPOSE 


SYNTAX 


COMMENTS 


Writes a specified number of lines to disk from 
the lines that are being edited in memory. 
Lines are written to disk beginning with line 
number 1. 


[n]W 


This command is meaningful only if the file 
you are editing is too large to fit into memory. 
When you start EDLIN, EDLIN reads lines into 
memory until memory is 3/4 full. 


To edit the remainder of your file, you must 
write edited lines in memory to disk. Then you 
can load additional unedited lines from disk 
into memory by using the Append command. 


Note: If you do not specify the number 
of lines, lines are written until memory 
is 3/4 full. No action is taken if 
available memory is already less than 
3/4 full. All lines are renumbered, so 
that the first remaining line becomes 
line number 1. 
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Error Messages 


When EDLIN finds an error, one of the following error messages 
is displayed: 


Cannot edit .BAK file—rename file 
You attempted to edit a file with a filename extension of .BAK. 
reserved for backup copies. 


If you need the .BAK file for editing purposes, you must either 
RENAME the file with a different extension; or COPY the BAK 
file and give it a different filename extension. 


No room in directory for file 
When you attempted to create a new file, either the file directory 
was full or you specified an illegal disk drive or an illegal filename. 


Check the command line that started EDLIN for illegal filename 
and illegal disk drive entries. If the command is no longer on the 
screen and if you have not yet typed a new command, the EDLIN 
start command can be recovered by pressing the (F3) key. If this 
command line contains no illegal entries, run the CHKDSK 
program for the specified disk drive. If the status report shows 
that the disk directory is full, remove the disk. Insert and format 
a new disk. 


Entry Error 
The last command typed contained a syntax error. Retype the 
command with the correct syntax and press (RETURN). 


Line too long 

During a Replace command, the string given as the replacement 
caused the line to expand beyond the limit of 253 characters. 
EDLIN aborted the Replace command. 


Divide the long line into two lines, then try the Replace command. 
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Disk Full—file write not completed 

You gave the End command, but the disk did not contain enough 

free space for the whole file. EDLIN aborted the E command and 
returned you to the operating system. Some of the file may have 
been written to the disk. 


Only a portion (if any) of the file has been saved. You should 
probably delete that portion of the file and restart the editing 
session. The file is not available after this error. Always be sure 
that the disk has sufficient free space for the file to be written to 
disk before you begin your editing session. 


Incorrect MS-DOS version 
You attempted to run EDLIN under a version of MS-DOS that was 
not 2.0 or higher. 


You must make sure that the version of MS-DOS that you are 
using is 2.0 or higher. 


Invalid drive name or file 
You have not specified a valid drive or filename when starting 
EDLIN. 


Specify the correct drive or filename. 


Filename must be specified 
You did not specify a filename when you started EDLIN. 


Specify a filename. 


Insufficient memory 
There is not enough memory to run EDLIN. 


You must free some memory by saving the contents of memory to 
disk or by clearing memory before restarting EDLIN. 
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File not found 
The filename specified during a Transfer command was not found. 


Specify a valid filename when issuing a Transfer command. 


Must specify destination number 
A destination line number was not specified for a Copy or Move 
command. 


Reissue the command with a destination line number. 


Not enough room to merge the entire file 
There was not enough room in memory to hold the file during a 
Transfer command. 


You must free some memory by writing some files to disk or by 
deleting some files before you can transfer this file. 


File creation error 
The EDLIN temporary file cannot be created. 


Check to make sure that the directory has enough space to create 
the temporary file. Also, make sure that the file does not have the 
same name as a subdirectory in the directory where the file to be 
edited is located. 
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Overview 


LINK is an executable program on your MS-DOS Supplemental 
Programs diskette. LINK combines object modules that are the 
output of the MACRO-86 assembler or compatible compiler. It 
produces a relocatable run file (load module) and a list file of 
external references and error messages. 


To run LINK, you provide object, run, list, and library file 
parameters. You may optionally enter switches that modify the 
operation of LINK. 


“Invoking the Linker” describes the three ways to run LINK: 
interactive entry, command line entry, and automatic response file 
entry. Interactive entry is used most frequently, so its section 
contains information common to all three methods. 


If you are linking a high-level language program, the compiler 
determines the arrangement of your object modules in memory. If 
you are using assembler, however, you have more control over your 
program’s organization. The section “Segments, Groups, and 
Classes” shows you how to specify the order of your object modules 
at run time. 
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LINK File Usage 


The LINK process involves the use of several files. 


LINK: 

@ Works with one or more input files 

@ Produces two output files 

@ Creates a temporary disk file if necessary 


@ Searches up to eight library files 


The format for LINK file specifications is the same as that of any 
disk file: 


SYNTAX [d:[pathnamejfilename 


d: the drive designation. Permissible drive 
designations for LINK are A: through 0:. 


pathname a path of directory names. 


filename any legal filename of one to eight characters, 
plus an optional extension of 1 to 3 characters. 


ext a one- to three-character extension to the 
filename. 


VM.TMP 
FILE 
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If no filename extensions are given in the input 
(object) file specifications, LINK recognizes the 
following extensions by default: 


.OBJ Object 
-LIB Library 


LINK appends the following default extensions 
to the output (Run and List) files: 


-EXE Run(may not be overridden) 
-MAP List(may be overridden) 


LINK uses available memory for the link 
session. If an output file exceeds available 
memory, LINK creates a temporary file, names 
it VM.TMP, and puts it on the disk in the 
default drive. If LINK creates VM.TMP, it will 
display the message: 


VM. TMP has been created. 
Do not change diskette in drive, <d:> 


Once this message is displayed, do not remove 
the diskette from the default drive until the 
link session ends. If the diskette is removed, 
the operation of LINK is unpredictable and 
LINK usually displays the error message: 


Unexpected end of file on VM.TMP 
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CHANGING 
DISKETTES 


LINK writes the contents of VM.TMP to the 
file named following the Run File: prompt. 
VM.TMP is a working file only and is deleted at 
the end of the linking session. 


Do not use VM.TMP as a filename for any file. 
If LINK requires the VM.TMP file, LINK 
deletes the VM.TMP already on disk and 
creates a new VM.TMP. Thus, the contents of 
the previous VM.TMP file are lost. 


You may want to change diskettes during the 
link operation. If LINK cannot find an object 
file on the specified diskette, it prompts you to 
change diskettes rather than aborting the 
session. If you enter the /PAUSE switch, 
LINK pauses and prompts you to change 
diskettes before it creates the run file. You 
may change diskettes when prompted except in 
the following cases: 


@ the diskette you want to change has a 
VM.TMP file on it. 


@ you have requested a list file on the 
diskette you want to change. 
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Segments, Groups, and Classes 


The following terms are explained to help you understand how 
LINK works. Generally, if you are linking object modules from a 
high-level language compiler, you do not need to know these terms. 
If you are linking assembly language modules, read this section 


carefully. 


SEGMENT 


GROUP 


A segment is a contiguous area of memory up 
to 64K bytes in length. A segment may be 
located anywhere in 8086 memory on a 
“paragraph” (16 byte) boundary. The contents 
of a segment are addressed by a segment- 
register:offset pair. 


A group is a collection of segments. If you are 
using assembly language, you name the group. 
For high-level languages, the compiler names 
the group. 


The group is used for addressing segments in 
memory. Each group is addressed by a single 
segment register The segments within the 
group are addressed by the segment register 
plus an offset. LINK checks to see that the 
total sizes of the object modules within one 
group do not exceed 64K. A program consists 
of one or more groups. 
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CLASS 


A class is a collection of segments. You assign 
the class name for assembly language 
programs; the compiler assigns the class name 
for high-level language programs. 


Segments are grouped together by the class 
name found in the object modules. Classes may 
be loaded across 64K byte boundaries. LINK 
divides classes into groups that are no longer 
than 64K. 


Example: 


Segment Name Name Segment Class 


Segment 1 PROG.1 CODE 
Segment 2 PROG.2 CODE 
Segment 12 PROG.3 DATA 


Note that segments 1, 2, and 12 have different 
segment names, but may or may not have the 
same segment class name. Segments 1, 2, and 
12 form a group with a group address of the 
lowest address of segment 1 (i.e., the lowest 
address in memory). 
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Each segment has a segment name and a class 
name. LINK loads all segments into memory 
by class name from the first segment 
encountered to the last. All segments assigned 
to the same class are loaded into memory 
continuously. 


During processing, LINK references segments 
by their address in memory (where they are 
located). LINK does this by finding groups of 
segments. 
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Invoking LINK 


-_— 


WAYS TO 
INVOKE 
LINK 


Interactive 
Entry 


LINK is invoked in one of three ways. The 
first method, interactive entry, requires you to 
respond to individual prompts. 


For the second method, command line entry, 
type all commands on the same line used to 
start LINK. 


To use the third method, automatic response 

file entry, create a response file that contains 

all the necessary commands and tell LINK 

where that file is when you run LINK. 

Interactive Entry LINK 

Command Line Entry LINK filenames[/switches] 


Automatic Response LINK @filename 
File Entry 


To invoke LINK interactively, type: 


LINK 
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LINK loads into memory, then displays four 
prompts, one at a time. At the end of each 
line, you may type one or more switches 
preceded by a forward slash. 


The command prompts are summarized below. 
Defaults appear in square brackets ({]) after 
the prompt. Object Modules is the only prompt 
that requires a response. 


Object Modules[.OBJ]: — {d:][path]name[-ext] 
[{+[d:][path][name].ext]]... 


Run File[name.EXT]: (d:][path][name[.ext]] 
List File[NUL.MAP]: — [d:][path][name[-ext]] 


Libraries[.LIB]: (d:][path][name[.ext]] 
[+d:][{[path]name[-ext]]]... 


Note 1: If you enter a filename 
without specifying the drive, the default 
drive is assumed. If you enter a 
filename without specifying the path, 
the default path is assumed. The 
libraries prompt is an exception—if the 
linker looks for the libraries on the 
default drive and doesn’t find them, it 
looks on the drive specified by the 
compiler. 
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OBJECT 
MODULES 
TO BE 
INCLUDED 


Note 2: To select default responses to 
the remaining prompts, use a single 
semicolon (;) followed immediately by 
(RETURN) at any time after the first 
prompt (Run File:). 


Once you enter the semicolon, you can 
no longer respond to any of the prompts 
for that link session. Use to 
skip prompts. 


Note 3: Use (crr)C to abort the link 
session at any time. 


Object Modules[.OBJ]: 


List .OBJ files to be linked. They must be 
separated by blank spaces or plus signs (+). If 
the plus sign is the last character typed, this 
prompt will reappear so that you can enter 
more object modules. 


LINK assumes that object modules have the 
extension .OBJ unless you explicitly specify 
some other extension. Object filenames may 
not begin with the @ symbol (@ is used for 
specifying an automatic response file). 
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Load Module 


Listing 


The order in which you key in the object files is 
significant. See section on segments, groups, 
and classes for more information. 


Run File [O0bj-file.EXE]: 


Give filename for executable object code. The 
default is: <first-object-filename>.EXE. You 
cannot change the output extension. You can 
specify just the drive designation or just a 
path. 


List File [NUL.MAP]: 


Give filename for listing (also known as a 
linker map). The listing is not created if you 
select the default. You can request a listing by 
entering a drive designator, path, or 
name{.ext]. If you do not specify an extension, 
the default MAP is used. 


You can have the listing printed by specifying a 
print device instead of a filename or have the 
listing displayed on the screen by specifying 
CON. If you display the linker map, you can 
also print it by pressing (rat) and (Prsc). 
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Libraries To 
Be Searched 


Libraries [.LIB} 


List filenames to be searched separated by 
blank spaces or plus signs (+). If a plus sign is 
the last character typed, the prompt will 
reappear. 


LINK searches library files in the order listed 
to resolve external references. When it finds 
the module that defines the external symbol, 
LINK processes that module as another object 
module. 


There is no default library search for MACRO 
assembler object modules. For compiled 
modules, if you select the default for this 
prompt, LINK looks for the compiler package's 
library on the default drive. If not found there, 
LINK looks on the drive specified by the 
compiler. 


If LINK cannot find a library file, it displays: 


Cannot find library <library-name> 
Type new drive letter: 
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LINK Switches 


The seven LINK switches control various LINK functions. Type 
switches at the end of a prompt response regardless of which 
method you use to start LINK. Switches may be grouped at the 
end of any response, or may be scattered at the end of several. If 
you type more than one switch at the end of one response, each 
switch must be preceded by a forward slash (/). 


All switches may be abbreviated. The only restriction is that an 
abbreviation must be sequential from the first letter through the 
last typed, no gaps or transpositions are allowed. For example: 


Legal Illegal 
/D /DSL 
/DS /DAL 
/DSA /DLC 


/DSALLOCA /DSALLOCT 


/DSALLOCATE /DSALLOCATE tells LINK to load all data at 
the high end of the data Segment. Otherwise, 
LINK loads all data at the low end of the Data 
Segment. At runtime, the DS pointer is set to 
the lowest possible address to allow the entire 
DS segment to be used. 
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/BIGH 


/LINE- 
NUMBERS 


Use of /DSALLOCATE in combination with the 
default load low (that is, the /HIGH switch is 
not used) permits the user application to 
dynamically allocate any available memory 
below the area specifically allocated within 
DGroup yet to remain addressable by the same 
DS pointer. This dynamic allocation is needed 
for Pascal and FORTRAN programs. 


Your application program may dynamically 
allocate up to 64K bytes (or the actual amount 
of memory available) less the amount allocated 
with DGroup. 


/HIGH causes LINK to place the Run file as 
high as possible in memory. Otherwise, LINK 
places the Run file as low as possible. 


Note: Do not use /HIGH with Pascal 
or FORTRAN programs. 


/LINENUMBERS tells LINK to include in the 
List file the line numbers and addresses of the 
source statements in the input modules. 
Otherwise, line numbers are not included in the 
List file. 
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/MAP 


/PAUSE 
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Not all compilers produce object modules that 
contain line number information. In these 
cases, of course, LINK cannot include line 
numbers. 


/MAP directs LINK to all public (global) 
symbols defined in the input modules. If /MAP 
is not given, LINK will list only errors 
(including undefined globals). 


The symbols are listed alphabetically. For each 
symbol, LINK lists its value and its 
segmentioffset location in the Run file. The 
symbols are listed in the end of the List file. 


/PAUSE causes LINK to pause in the link 
session when the switch is encountered. 
Normally, LINK performs the linking session 
from beginning to end without stopping. This 
switch enables you to swap the diskettes before 
LINK outputs the Run (.EXE) file. 


When LINK encounters /PAUSE, it displays 
the message: 


About to generate -EXE file 
Change disks chit any key> 
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/STACK: 


<number> 


LINK resumes processing when you press any 
key. 


Note: Do not remove the disk which 
will receive the List file, or the disk 
used for the VM.TMP file, if one has 
been created. 


Stack number represents any positive numeric 
value (in hexadecimal radix) up to 65536 bytes. 
If a value from 1 to 511 is typed, LINK will use 
512. If /STACK is not used for a link session, 
LINK calculates the necessary stack size 
automatically. 


All compilers and assemblers should provide 
information in the object modules that allow 
the linker to compute the required stack size. 


At least one object (input) module must contain 
a stack allocation statement. If not, LINK will 
display the following error message: 


WARNING:NO STACK STATEMENT 


/NO 
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/NO is short for NO DEFAULT LIBRARY- 
SEARCH. This switch applies only to higher 
level language modules. This switch tells LINK 
not to search the default libraries in the object 
modules. 


For example, if you are linking object modules 
in Pascal, specifying /NO tells LINK not to 
automatically search the library named 
PASCAL.LIB to resolve external references. 
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Command Line Entry 


e—e 


You may invoke LINK by typing all commands on one line. The 
entries following LINK are responses to the command prompts. 
The entry fields for the different prompts must be separated by 
commas. Use the following syntax: 


SYNTAX LINK <obj-list>,<runfile>,<listfile>, 
<lib-list>|/switch...] 


obj-list a list of object modules, separated by plus 
signs. 

runfile name of the file to receive the executable 
output. 

listfile name of the file to receive the listing. 

lib-list list of library modules to be searched. 

/switch refers to optional switches which may be placed 


following any of the response entries (just 
before any of the commas or after the 
<lib-list>, as shown). 
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AUTOMATIC 
RESPONSE 
FILE ENTRY 
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To select the default for a field, simply type a 
second comma with no spaces between the two 
commas. 


Example: 


LINK 
FUN+TEXT+TABLE+CARE , FUNLIST , 
COBLIB.LIB 


It is often convenient to save responses to the 
linker for re-use at a later time. This is 
especially useful when a long list of object 
modules needs to be specified. 


Before using this option, you must create the 
response file. Each line of text corresponds to 
one LINK prompt. The responses must be 
typed in the same order as they are when 
entered interactively. To continue a line, type a 
plus sign (+) at the end of the line. 
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You can enter the name of more than one 
automatic response file on the command line 
and combine response file names with 
additional parameters. The combined series of 
resulting parameters must be a valid sequence 
of LINK prompts. 


Use switches and special characters (+ and ;) in 
the response file the same way they are used 
when entered interactively. 


To invoke the linker using a response file, type 
LINK @<filename> 


Filename is the name of a response file. The 
extension is not required. 


When the session begins, LINK displays each 
prompt with the corresponding response from 
the response file. If the response file does not 
contain answers for all the prompts, LINK 
displays the prompt which does not have a 
response and waits for a response. When you 
type a legal response, LINK continues the link 
session. 
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Example: 


FUN TEXT TABLE CARE 
/PAUSE/MAP 

FUNLIST 

COBLIB.LIB 


This response file tells LINK to load the four 
object modules named FUN, TEXT, TABLE, 
and CARE. LINK pauses before producing a 
public symbol map to permit you to swap disks. 
When you press any key, the output files will 
be named FUN.EXE and FUNLIST.MAP. 
LINK will search the library file COBLIB.LIB 
and will use the default settings for the 
switches. 
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Sample Link Session 
———— ee Te 


This sample shows you the type of information displayed during an 
LINK session. 


In response to the MS-DOS prompt, type: 
LINK 


The system displays the following messages and prompts: 


Microsoft Object Linker V2.01 
© Copyright 1982, 1983 by Microsoft Inc. 


Object Modules (.0BJ): 10 SYSINIT 
Run File (IO.EXE}: 

List File (NUL.MAPJ: 10 /MAP 
Libraries (.LIB_:; 


Note 1: By specifying /MAP, you get both an alphabetic 
listing and a chronological listing of public symbols. 


Note 2: By responding PRN to the List File: prompt, you 
can redirect your output to the printer. 


Note 3: By specifying the /LINE switch, LINK gives you 
a listing of all line numbers for all modules. (Note that 
/LINE can generate a large volume of output.) 
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Once LINK locates all libraries, the linker map displays a list of 
segments in the order of their appearance within the load module. 
The list might look like this: 


Start Stop Length Name 
OO000H OO9ECH O9EDH CODE 
OO9FOH 01166H 0777H SYSINITSEG 


The information in the Start and Stop columns shows the 20-bit 
hex address of each segment relative to location zero. Location 
zero is the beginning of the load module. 


The addresses displayed are not the absolute addresses where 
these segments are loaded. See the following section on the LINK 
DEBUG program for information on how to determine the 
absolute address of a segment. 
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ls 


Because the /MAP switch was used, LINK displays the public 
symbols by name and value. For example: 


ADDRESS PUBLICS BY NAME 
OO9F:0012 BUFFERS 

OO9F:0005 CURRENT MS-DOS LOCATION 
OO9F:0011 DEFAULT DRIVE 

OO9F: 000B DEVICE LIST 

OO9F:0013 FILES 

O09F:0009 FINAL MS-DOS LOCATION 
OO9F: OOOF MEMORY SIZE 

OO9F: 0000 SYSINIT 

ADDRESS PUBLICS BY VALUE 

O009F: 0000 SYSINIT 

OO9F: 0005 CURRENT MS-DOS LOCATION 
OO9F:0009 FINAL MS-DOS LOCATION 
OO9F: 000B DEVICE LIST 

OO9F : OOOF MEMORY SIZE 

OO9F:0011 DEFAULT DRIVE 

OO9F:0012 BUFFERS 

OO9F:0013 FILES 


C-26 


LINK Program 


LINK Error Messages 


All errors cause the link session to abort. After the cause has 
been found and corrected, LINK must be rerun. The following 
error messages are displayed by LINK: 


Attempt to access data outside of segment bounds, 
possibly bad object module 
There is probably a bad object file. 


Bad numeric parameter 
Numeric value is not in digits. 


Cannot open temporary file 

LINK is unable to create the file VM.TMP because the disk 
directory is full. Insert a new disk. Do not remove the disk that 
will receive the LIST.MAP file. 


Error: dup record too complex 
DUP record in assembly language module is too complex. Simplify 
DUP record in assembly language program. 


Error: fixup offset exceeds file width 

An assembly language instruction refers to an address with a 
short instruction instead of a long instruction. Edit assembly 
language source and reassembly. 


Input file read error 
There is probably a bad object file. 


Invalid object module 
An object module(s) is incorrectly formed or incomplete (as when 
assembly is stopped in the middle). 


Symbol defined more than once 
LINK found two or more modules that define a single symbol 


name. 
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Program size or number of segments exceeds capacity of 
linker 

The total size may not exceed 384K bytes and the number of 
segments may not exceed 255. 


Requested stack size exceeds 64K 
Specify a size greater than or equal to 64K bytes with the /STACK 
switch. 


Segment size exceeds 64K 
64K bytes is the addressing system limit. 


Symbol table capacity exceeded 
Very many and/or very long names were typed exceeding the limit 
of approximately 50K bytes. 


Too many external symbols in one module 
The limit is 256 external symbols per module. 


Too many groups 
The limit is ten groups. 


Too many libraries specified 
The limit is 8 libraries. 


Too may public symbols 
The limit is 1024 public symbols. 


Too many segments or classes 
The limit is 256 (segments and classes together total 256). 


Unresolved externals: <list> 
The external symbols listed have no defining module among the 


modules or library files specified. 
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VM read error 
This is a disk error; it is not caused by LINK. 


Warning: no stack segment 
None of the object modules specified contains a statement 
allocating stack space, but you typed the /STACK switch. 


Warning: segment of absolute or unknown type 
There is a bad object module or an attempt has been made to link 
modules that LINK cannot handle (e.g., an absolute object module). 


Write error in TMP file 
No more disk space remains to expand the VM.TMP file. 


Write error on run file 
Usually, there is not enough disk space for the Run file. 
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Overview 


DEBUG is an executable object program that resides on you MS- 
DOS Supplemental Programs diskette. DEBUG performs the 
following functions: 


@ Single step through a program, instruction by 
instruction, to examine registers and for testing 
purposes. 


@ Change register and file contents during the DEBUG 
session so you can test a code change without 
reassembling your program. 


@ Make permanent changes to disk files so you can use 
DEBUG to save files that may otherwise be lost. 


@ Translate machine code instructions into assembly 
language equivalents for testing purposes, with the U 
(Unassemble) command. 


D-3 


DEBUG Program 


Terms Used in DEBUG 


First, lets define the following DEBUG terms which are used in 


text: 


ADDRESS 


Refers to a specific memory location. There are 
several methods of addressing which allow you 
to point to specific memory locations, either 
directly or via a segment register. 


An address consists of a segment value and an 
offset value in this format: 


segment :offset 


If the colon separator is missing, DEBUG 
assumes the value is an offset and will use 
either the DS or CS register for the segment 
value, depending upon the command used. 


A segment register may be specified instead of 
an actual segment value like this: 


ES:0090 


DRIVE 


KEYLETTER 


PARAMETER 


RANGE 
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All of these are valid address parameters: 


0200 

A03B 
09AC:000A 
3A02:0A11 
DS:0300 
SS:A004 


Refers to a specific drive selection either 0, 1, 
or 2 depending on whether you wish to select 
drive A, drive B or drive C, respectively. For 
example, to select drive B type: 


Refers to the single letter designation 
(A,C,D,...) for the DEBUG command. 


Refers to the additional information following 
the keyletter that specifies exactly what the 
command is to perform. Mostly used to override 
defaults. Some commands do not require 
parameters and some parameters are optional. 


Refers to a range of addresses (memory 
locations). There are several formats which can 
be used to specify the range. 
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VALUE 


When you know the start and end addresses 
use this format: 


<start address>,<end address> 


When you know the start address and how 
many locations (value) are in the range use this 
format: 


<start address>L<value> 


Remember that value must be indicated in 
hex. For example, to address a range of 50 
locations starting with 0100 type: 


0100L32 


In both formats the range represents an offset. 
Therefore, the specified range cannot be 
greater that FFFF. 


You can also specify a segment address before 
the range like this: 


DS: 0300L32 


Refers to the contents or data of a memory 
address in a 1 to 4 character hexadecimal value. 
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How to Start DEBUG 


Start the DEBUG program by typing: 


SYNTAX DEBUG [filename],arglist] 
filename The name of the file to be debugged. 
arglist An optional list of filename parameters and 


switches, separated by commas. These will be 
passed to the program specified by the filename 
parameter. 


When the program is loaded into memory, it is loaded as if you 
had loaded the file without the DEBUG prefix. 


If you enter DEBUG without a filename, you can manipulate 
current memory disk blocks, or disk files since no filename has 
been specified. 


On entering the DEBUG environment, DEBUG responds with the 


hyphen “-” (prompt) and underline “_” (cursor). 


DEBUG 


You now may enter any DEBUG command. 


The DEBUG session will continue until you type Q or q to quit. 
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COMMENTS 


EXE Files 


HEX Files 


EXAMPLES 


If you include the filename in the command 
line, the specified file is loaded into memory 
starting at address 100H. 


If you specify a file with a .EXE extension, the 
program is loaded into memory starting at the 
address specified in the header of the file. 


If you specify a file with a HEX extension, the 
program is loaded into memory starting at the 
address specified in the HEX file. HEX files 
are in INTEL hex format and are converted to 
memory image format by DEBUG. 


To begin a DEBUG session without loading a 
file, type: 


DEBUG 


To begin a DEBUG session with the " myprog” 
file loaded into memory from drive B, type: 


DEBUG b:myprog [RETURN 


When you start DEBUG, it sets up a program segment prefix at 
offset 0 in the program work area. You overwrite this area if you 
enter DEBUG without parameters. 


D-8 


DEBUG Program 


Moreover, if you are debugging a file with a COM or EXE 
extension, do not tamper with the program header below location 
5CH, or DEBUG will terminate. 


Do not attempt to run a program after a Program terminated 


normally message is displayed. You must reload the program 
with the N (Name) and L (Load) commands for it to run properly. 
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DEBUG Commands 


The DEBUG program has these eighteen commands to perform 
everything described in this chapter: 


A - ASSEMBLE Assembles 8086 microprocessor mnemonics 
directly into memory. 


C - COMPARE Compares the contents of two areas of 
memory. 

D - DISPLAY Displays an area of memory. 

E - ENTER Changes the value of consecutive memory 
addresses. 

F - FILL Fills a range of memory addresses with 


specified values. 


G-GO Executes the program currently in memory, 
optionally pausing at specified addresses to 
display information about the system and 
program environment. 


H - HEX Calculates and displays the sum and the 
difference of two hexadecimal values. 


1- INPUT Inputs a value from an address (I/O port) 
and displays the value. 


L-LOAD Loads a file or absolute disk blocks into 
memory. 


M- MOVE 


N-NAME 


O - OUTPUT 


Q- QUIT 


R - REGISTER 


S - SEARCH 


T - TRACE 


U - UNASSEMBLE 


W - WRITE 
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Copies (moves) the values of a specified 
range of memory addresses (source) to 
another range of memory addresses 
(destination). 


Provides filenames for the L (Load) and W 
(Write) commands or filename parameters 
for the program to be debugged. 


Outputs a value to an address (I/O port) and 
displays the value. 


Terminates the DEBUG program. 


Displays the contents of the registers and 
flag settings, with the option to change the 
values. 


Searches a range of addresses for a specified 
value(s). 


Executes one or more instructions and 
displays the register values, flag settings 
and the next instruction to be executed. 


Disassembles strings of values in memory 
and displays them as assembler-like 
statements along with their corresponding 
addresses. 


Writes a file or absolute disk blocks to disk 
from memory. 
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The following rules apply to the use of DEBUG commands: 
@ Commands can be entered in either lowercase or uppercase. 


@ All commands are entered using the keyletter followed by 
the parameters. Here are some examples: 


DO100,03A0 
cO9ACLFF , 0300 
MCS:100,110,CS:500 


Command parameters can be separated from each other by 
spaces or commas for readability but need not be, except 
where two hexadecimal numbers are entered as 
parameters, in which case they must be separated by a 
comma or space. For brevity, the syntax of this chapter 
will always indicate a comma where separation is 
obligatory, but note that a space can alternatively be used. 


@ Commands become effective only after typing (RETURN). 


@ If you make a syntax error when entering a command, the 
* Error message will be displayed on the following line. 
You must re-enter the command using the correct syntax. 


Any DEBUG command may be aborted at any time by pressing 
(GirC. Pressing IS suspends the display, so that you can read 
it before the output scrolls away. After suspending the display, 
press any key (except (rRU)S or (CrRIC) to continue scrolling. 


The DEBUG commands follow individually in alphabetical order. 
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A (ASSEMBLE) 


ll 


PURPOSE Assembles 8086 microprocessor mnemonics 
directly into memory. 


SYNTAX A{address] 


address Address is the start address into which the 
subsequently entered line of mnemonics is to be 
assembled. If this parameter is omitted, 
location 100 is assumed, if you did not enter an 
Assemble command previously. If you did 
enter Assemble previously, the code assembles 
into the address following the last instruction 
loaded by the previous Assemble command. 


After you enter the Assemble command, DEBUG displays the 
specified address followed by the cursor you may then enter a line 
of 8086 microprocessor mnemonics. On terminating the line with 
(RETURN), the line will be assembled into memory starting at the 
specified location. The subsequent address to the assembled code 
will be displayed on the next line along with the cursor to enable 
you to enter the next line of code. If, instead of a line of 8086 
microprocessor mnemonics, you simply type (RETURN), the Assemble 
command terminates and the DEBUG prompt reappears. 


COMMENTS 


@ All values are hexadecimal and must be entered as 1 to 4 
characters. Prefix mnemonics must be specified in front of the 
opcode to which they refer. You may also enter them ona 
separate line. 
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The segment override mnemonics are CS, DS, ES, and SS. The 
mnemonics for the far return is RETF. String manipulation 
mnemonics must explicitly state the string size. For example, 
use MOVSB to move byte strings. 


The Assemble command will automatically assemble short, 
near, or far jumps and calls, depending on byte displacement 


with respect to the destination address. These may be 
overridden with the NEAR or FAR prefix. For example: 


0100:0500 JMP 502 3a two-byte short jump 
0100:0502 JMP NEAR 505 ;a three-byte near jump 
0100:0505 JMP FAR 50A_—;a five-byte far jump 


The NEAR prefix may be abbreviated to NE, but the FAR 
prefix cannot be abbreviated. 


DEBUG cannot tell whether some operands refer to a word 
memory location or to a byte memory location. In this case 
the data type must be explicitly stated with the prefix WORD 
PTR or BYTE PTR. Acceptable abbreviations are WO and 
BY. For example: 


NEG BYTE PTR [128] 
DEC Wo [SI] 
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DEBUG cannot distinguish whether an operand refers to a 
memory location or to an immediate operand. Enclose 


operands that refer to memory locations in square brackets. 
For example: 


MOV AX,21 s;Load AX with 21H 
MOV AX,[21] ;Load AX with the contents of 
;location 21H 


Two pseudo-instructions are available with the Assemble 


command. The DB opcode will assemble word values directly 
into memory. For example: 


DB 1,2,3,4,"THIS IS AN EXAMPLE" 
DB "THIS IS A QUOTE:" 

DB "THIS IS A QUOTE’ " 

DW 1000, 2000,3000," BACH’ 


The Assemble command supports all forms of register indirect 
addressing. For example: 


ADD BX,34[BP+2]. [SI-1] 
POP [BP+DI] 
PUSH [ST] 


All opcode synonyms are supported. For example: 


LOOPZ 100 
LOOPE 100 
JA 200 

JNBE 200 
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-—_e—e——— 


EXAMPLE To assemble starting at location 200: 


1 Type A200 (RETURN). 
DEBUG displays: 


-A200 
09AC:200_. 


2 Type MOV AX, [21] (RETURN). 


The 8086 microprocessor mnemonics are 
assembled starting at location 200. The 
next address subsequent to the assembled 
code is then displayed: 


-A200 
O9AC:0200MOV AX, [21] 
09AC:0203__ 


3 Type (Return). 


The Assemble command terminates and the 
DEBUG prompt reappears. 


-A200 
O9AC:0200MOV AX, [21] 
O9AC:0203 
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C (COMPARE) 


PURPOSE Compares the contents of two areas of memory. 
SYNTAX C<range>,address 
range The range of addresses defining the first area 


to be compared. If no segment is specified, 
then the entire segment specified in the DS 
register is assumed. 


address The first address of the area to be compared 
with the area specified by the range parameter. 


The Compare command compares the area of memory specified by 


the range parameter with an area of the same size starting at the 
address specified by the address parameter. 


COMMENTS 


© Ifthe contents of the two areas are identical, nothing is 
displayed. 


© If there are differences, then the differences are displayed 
(per-line) in the format: 


adrs1 cnts1 ents2 adrs2 


adrs1 indicates the address in the first area and ents] its 
contents. adrs2 indicates the corresponding address in the 
second area and ents2 its contents. 
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EXAMPLE To compare 100 addresses starting at A500 with 
100 addresses starting at B200: 


1 Type CA500,A564,B200 (RETURN), or 
CA500L64,B200 (RETURN). 


DEBUG Displays: 


-CA500L64 , B200 

A502 00A4 00A3 B202 
A503 0001 0000 B203 
A530 09AA 034C B230 


The display indicates that after comparing 
addresses (locations) A500 through A564 
with addresses B200 through B264; 
addresses A502, A503, and A530 were 
different. 
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D (DISPLAY) 


PURPOSE Displays an area of memory. 
SYNTAX D(range} 
or 
D{address] 
range The range of addresses whose contents are to 


be displayed. If you enter only an offset, then 
the segment specified in the DS register is 
assumed. 


address The address from which the display is to start. 


The contents of this address and the next 127 
locations are displayed. 


COMMENTS 


If D is specified without parameters, then the 128 addresses 
following the last address to be accessed are displayed. If no 
address has yet been accessed, the display will start from 
location DS:100. 


If D and the range parameter are specified, the contents of 
that range of addresses are displayed. If this takes more than 
24 screen lines, the display is scrolled until the contents of the 
final address in the range are displayed on line 24. 
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The address values are displayed (per-line) in this format with 
a hyphen" -" between v+7 and v+8: 


adrs v v+1 ... v+15 <ASCv><ASCv+1>...<ASCv+15> 


adrs indicates the address, v its hex value, v+1 the hex value 
of the next address, and so on. ASCv through ASCv+15 
indicate the ASCII characters of the corresponding address. 
The character dot "." is displayed when the value does not 
have a printable ASCII character. 


Each line displays the hex value and ASCII character for 16 
addresses. The next line starts with the address following the 
v+15 location. 


EXAMPLE 1 To display the values of addresses 0100 through 


0110 type: 


1 Type D100,110 (RETURN). 


DEBUG displays the address followed by 
the next 16 addresses, with a hyphen " -" 
between addresses 8 and 9. Then the ASCII 
character of all 16 addresses, if printable. 


-D0100,0110 
09AC:0100 ES 09 ... 9B-DF ... O1 ........ eee eeeee 
09AC:0110 00 
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EXAMPLE 2 To display the next 128 addresses: 


1. Type D (Return). 
DEBUG Displays: 


-D 

09AC:0110 20-54 ... 20 THIS IS TEXT IN 

09AC:0120 43-41 . 46 DATA LOCATIONS F 
09AC:0130 4D-50 ... 54 OR A SAMPLE OF T 
09AC:0140 4C-41 ... 41 HE DISPLAY COMMA 
09AC: 0150 48-45 ... 20 ND IN THE DEBUG 

09AC: 0160 00-00 ... 00 PROGRAM........ . 
09AC:0170 00-00 ... . 

09AC:0180 00-00 ... see 
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E (ENTER) 


ENE 


PURPOSE Changes the value of consecutive memory 
addresses. 

SYNTAX E<address>{,value,value+l....] 

address The address of the location whose value is to be 


changed; or the address of the first of a 
succession of locations whose contents are to be 
replaced. If only an offset is specified, then the 
segment indicated by the DS register is 
assumed. 


value The data that is to replace the contents of the 
specified address. The contents of the memory 
locations are changed. That is, the first value 
will replace the contents of the location 
specified by the address. A second value will 
replace the contents of the location following 
that specified by the address, and so on. 


COMMENTS 


@ Ifthe command is entered without value parameters, DEBUG 
displays the specified address and its value. This command 
then waits for you to perform one of the following: 


1 Change the displayed value by entering another value. To 
do this you, type the new value after the current value. If 
you enter an illegal value, or if you type more than two 
digits, the illegal or extra character is not echoed. 
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2 Type to continue to the next address. To change 
this value, simply enter a new value as described above. To 
advance to the next address without changing the current 
value, press (SPACE) again. 


3 Type GQ, to return to the previous address. DEBUG then 
starts a new display line with the address you have 
returned to and its value. You can then change the value 
of this address as described above. To move back one 
address further without changing this value, type 0) 
(hyphen) again, and another new line will be displayed. 
You can continue back to the address specified in the 
command. 


@ If you advance beyond eight addresses on one line, DEBUG 
starts a new display line with the address displayed at the 
start of the line. 


@ Ifyou specify values, then the first of these values will 
replace the value at the address specified by the address 
parameter. Subsequent values in the command will replace 
subsequent values of addresses in memory. 
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EXAMPLE 1 To change the value of three consecutive 
addresses starting at address 100: 


1 Type E0100 (Return). 
DEBUG displays: 


-E0100 
058D:0100 CD._ 


2 Type 26. 


The value of address 100, which was CD, is 
now changed to 26. DEBUG then displays: 


-E0100 
058D:0100 CD.26_ 


3 Type (pace). 


DEBUG displays the value of the next 
address (101): 


-E0100 
058D:0100 CD.26 20._ 
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4 Type 19. 


The value of address 101, which was 20, is 
now changed to 19. DEBUG then displays: 


-E0100 
058D:0100 CD.26 20.19_ 


Type (SPACE). 


DEBUG displays the value of the next 
address (102): 


-E0100 
058D:0100 CD.26 20.19 OA._ 


Type 23 (RETURN). 


The value of address 102, which was 0A, is 
now changed to 23. The enter command is 
terminated and DEBUG then displays: 


-E0100 
058D:0100 CD.26 20.19 0A.23 


DEBUG Program 


EXAMPLE 2 


EXAMPLE 3 


EXAMPLE 4 


Another way to change the value of the same 
three addresses: 


1 Type E0100,26,19,23 (RETURN). 


The values of addresses 100, 101, and 102 
which were CD, 20, and 0A are now 
changed to 26,19, and 23. DEBUG then 
displays: 


-E0100, 26,19,23 
058D:0100 CD.26 
058D:0101 20.19 
058D:0102 0A.23 


If you change the first and third addresses and 
not the second address. That is, you typed 
(SPACE) instead of changing the second address. 
The display would look like this: 


-E0100 
058D:0100 CD.26 20. 0A.23 


If you change the first two addresses, but 
change your mind on the value in the second 
address. That is, you typed Q instead of a new 
value for the third address. The display would 
look like this: 


-E0100 
058D:0100 CD.26 20.19 OA. 
058D:0101 19._ 
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F (FILL) 


PURPOSE Fills a range of memory addresses with 
specified values. 


SYNTAX F<range>,value[,value+1,value+2...] 


range The range of addresses whose values are to be 
changed with the specified values. If only the 
offset is specified, then the segment indicated 
by the DS register is assumed. 


value A two digit hexadecimal value that is to change 
the value of the specified address(es). 


COMMENTS 


@ If the specified range contains more addresses than the list of 
values, then the list of values is repeated until the specified 
range is filled. If a range of six addresses and three values are 
specified, the first and forth, second and fifth, and third and 
sixth addresses will contain the same values. 


@ If the list of values contains more values then the range has 
addresses, the extra values are ignored. 
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eee 


EXAMPLE To fill 100 addresses with 00 starting at address 
300: 
1. Type F0300L64,00 (RETURN). 
DEBUG displays: 


-FO300L64 ,00 


The display indicates that addresses 0300 
through 0364 (hex for 100) now contain 00. 
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G (GO) 


PURPOSE Executes the program currently in memory, 
optionally pausing at specified addresses to 
display information about the system and 
program environment. 


SYNTAX G{=address|,address...] 

=address The address in memory at which program 
execution is to start. "=" is used to 
distinguish a start address from a pause 
address. 

address The pause address or addresses. You can 


specify up to ten addresses, in any order. 


If you enter G without parameters, the program currently in 
memory is executed starting from the address specified by the CS 
and IP registers. The program will not pause. 


COMMENTS 


@ If you specify the =address parameter, the contents of the CS 
and IP registers are changed to those specified by the 
=address parameter and the program in memory is executed, 
starting from the address you specified. 


© If you specify one or more pause addresses, program execution 
stops at the first such address encountered and displays the 
contents of the registers, the state of the flags and the next 
instruction to be executed (see the R [register] command for a 
description of the display). 
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————— 


© If only an offset is entered for an address, the command 
assumes the segment in the CS register. 


@ If you enter more than ten addresses, DEBUG will display: 
BP Error 


@ Before executing the program, the command changes the value 
of the pause addresses (locations) with an interrupt instruction 
(CC). Then program execution will pause at these addresses. 


DEBUG restores the original values of all the specified 
addresses. However, if the program terminates normally (that 
is, not at a specified address), the original values are not 
restored. 


Note: Once a program has reached completion 
(DEBUG has displayed Program terminated 
normally) you must reload the program before you 
can run it again. 


@ Fach pause address that you specify must point to the first 
address of an 8086 microprocessor instruction, or unpredictable 
results occur. 


@ The stack segment (SS register) must have six addresses 
available for this command, otherwise unpredictable results 
occur. 
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EXAMPLE To run a program starting at address 300 with 
pauses at addresses 303, and 308 (assume 
program extends beyond address 308): 


1 Type G=0300,0303,0308 (RETURN). 


DEBUG displays: 


-G=0300 , 0303, 0308 


AX=0000 BD=0000 CS=0000 Dx=0000 
SP=FFFO BP=0000 SI=0000 DI=0000 DS=0000 
ES=0000 CS=0000 IP=013B 

NV UP EI PL NZ NA PO NC 

0000:013B 083D8 MOV DS,AX 


AX=0000 BD=0000 CS=0000 Dx=0000 
SP=FFFO BP=0000 SI=0000 DI=0000 DS=0000 
ES=0000 CS=0000 IP=013B 

NV UP EI PL NZ NA PO NC 

0000:013B 083D8 MOV DS,AX 

Program terminates normally 
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H (HEX ARITHMETIC) 


PURPOSE Calculates and displays the sum and the 
difference of two hexadecimal values. 


SYNTAX H<value-a>,<value-b> 
value-a The first of two hexadecimal values. 
value-b The hexadecimal value that is to be added to or 


subtracted from value-a. 


COMMENTS 


@ The hexadecimal values may be up to four characters long. 


@ The Hex command displays two four-digit values; the first is 
the result of adding value-b to value-a and the second is the 
result of subtracting value-b from value-a. 
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EXAMPLE To determine the sum and the difference of 
O19F and 010A: 


1. Type HO19F,010A (ReTuRN). 


DEBUG displays: 


-HO19F,010A 
02A9 0095 


To determine the sum and the difference of 
FFFF and 0002: 


| Type HFFFF,0002 (RETURN). 


DEBUG displays: 


-HFFFF , 0002 
0001 FFFD 
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I (INPUT) 


PURPOSE Inputs a value from an address (I/O port) and 
displays the value. 


SYNTAX I<address> 


address The address of the port that the value is to be 
inputed from. 


COMMENTS The address, of the I/O port, can be up to 16 
bits wide. 


EXAMPLE To input a value from address (I/O port) 32F8 
(assume address 32F$8 is an input port): 


1 Type 132F8 (RETURN). 


DEBUG displays: 


-112F8 
0000:12F8 6A 
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L (LOAD) 


PURPOSE 


SYNTAX 


address 


drive 


block 


value 


COMMENTS 


Loads a file or absolute disk blocks into 
memory. 


L{address],drive,block,value] 


The starting address in memory at which the 
file or specified blocks is to be loaded from. If 
only an offset is entered, then the segment 
indicated by the CS register is assumed. 


The drive from which disk blocks are to be 
loaded. For drive A you must enter 0, for drive 
B you must enter 1, for drive C you must enter 
2, and so on. 


The first of a range of blocks to be loaded from 
the disk specified by the drive parameter. 


The number of blocks to be loaded. 


@ If all parameters are specified, then DEBUG loads blocks of 
information from disk into memory. 
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If you specify L with just the address parameter, the file 
whose file control block is correctly formatted at location 
CS:5C is loaded into memory. The file control block at CS:5C is 
set either to the filename specified when the DEBUG command 
was invoked, or to the filename specified by the most recent 
execution of the N (Name) command. 


If L is specified without parameters, the file is loaded starting 
at address CS:100. 


If L and the address parameter are specified, the file is loaded 
starting at the specified address. In either case DEBUG sets 
the BX:CX registers to the number of addresses loaded. 


If the file has an EXE extension, then it is relocated to the 
load address specified in the header of the EXE file. That is, 
the address parameter to the Load command is ignored. The 
header itself is stripped off the EXE file before the file is 
loaded into memory. Thus the size of the EXE file on disk will 
differ from its size in memory. 


If the file has an HEX extension, entering the command with 
no parameters causes the file to be loaded starting at the 
address specified within the HEX file. If the address 
parameter, however, is specified, then loading starts at the 
address which is the sum of the address specified and the 
address in the HEX file. 


DEBUG Program 


EXAMPLE 1 To load the file myprog starting at address 
0200: 


1 Type Nmyprog (ReTuaN). 
DEBUG displays: 


-Nmyprog 


The N (Name) command identifies the 
filename for the load command. 


2 Type L0200 (RETURN). 


The file myprog is loaded into memory 
starting at address 0200. DEBUG then 
displays: 


-Nmyprog 
-L0200 


EXAMPLE 2 To relocate the file in memory starting at 
address 0A00: 


1. Type LOAOO (RETURN). 
DEBUG Displays: 


-LOA0O 
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M (MOVE) 
———EESESESE—— 


PURPOSE Copies (moves) the values of a specified range 
of memory addresses (source) to another range 
of memory addresses (destination). 


SYNTAX M<range>,address 


range The area of memory whose contents are to be 
moved. If you only enter an offset, the segment 
indicated in the DS register is assumed. 


address The start of the destination area. If you only 
entered an offset, then the segment indicated 
by the DS register is assumed. 


COMMENTS 


© If the source and destination areas overlap, the move is 
performed without loss of data. 


The contents of the source area are not changed by the move, 
unless the destination area overlaps it. 


© If you specify an address as the end of the range, you must 
only enter the offset. The segment specified, or defaulted to, in 
the start address of the range is assumed. 
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EXAMPLE To copy the values of 32 addresses starting at 
address 0300 to the area of memory starting at 
address 0500: 


1. Type M0300L20,0500 (RETURN). 


DEBUG displays: 


-MO300L20,0500 


The 32 addresses specified are copied io 
memory starting at address 0500. 
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N (NAME) 


PURPOSE Provides filenames for the L (Load) and W 
(Write) commands or filename parameters for 
the program to be debugged. 


SYNTAX N<filename>(,filename...] 


filename The file to be loaded into memory, written to 
diskette, or used as a filename parameter to the 
file currently in memory. 


The name command can be used to provide: 


@ The name of the disk file to be loaded into memory by a 
subsequent L (Load) command. You can enter the DEBUG 
program without specifying parameters, then use this 
command to name the disk file you wish to debug, then load 
the file into memory using the L (Load) command. This has 
the same effect as entering the filename as the first parameter 
to the DEBUG command. The file contro! block for the file to 
be debugged is set up at location CS:5C and the file is loaded. 


@ The name to be assigned to the file currently in memory when 
the file is subsequently written to disk. That is, the file is 
already in memory and the Name command sets up the file 
control block for the specified file at location CS:5C. 


When a W (Write) command is subsequently entered the file in 
memory is written to disk with the filename whose file control 
block is set up at location CS:5C. 


DEBUG Program 


@ Filename parameters to the file in memory to be debugged. 
The Name command provides filename parameters for the 
program currently in memory. 


Whatever file control block was set at CS:5C is replaced by 
that of the first such parameter. If a second file parameter is 
specified, its file control block is set up at location CS:6C. Only 
two file control blocks are set up, although additional filename 
parameters may be included if required. 


All the filenames specified are placed in a save area at CS:81, 
with CS:80 containing a character count. Parameters specified 


in this way an analogous to filenames specified in the 
argument list to the DEBUG command. 


COMMENTS None 
EXAMPLE 1 To specify the file myprog: 


1 Type Nmyprog (Return). 
DEBUG displays: 


-Nmyprog 


The L (Load) and W (Write) commands can 
now be used. 


DEBUG Program 


EXAMPLE 2 


To load the file myprog starting at address 
0300 and run it: 


1 


Type Nmyprog (RETURN). 


DEBUG displays: 


-Nmyprog 


Type L0300 (RETURN). 


The file myprog is loaded in to memory 
starting at address 0300. DEBUG then 
displays: 


-Nmyprog 
-L0300 


Type G=0300 (RETURN). 


DEBUG runs the file myprog starting at 
address 0300, then displays: 


-Nmyprog 
-L0300 
-G=0300 


DEBUG Program 


O (OUTPUT) 


PURPOSE 


SYNTAX 


address 


value 


COMMENTS 


EXAMPLE 


Outputs a value to an address (I/O port) and 
displays the value. 


O<address>,value 


The address of the port that the value is to be 
sent to. 


The contents to be sent, via the specified 
address a two-digit hexadecimal value to be 
sent to the specified port. 


The address, of the I/O port, can be up to 16 
bits wide. 


To output the value 3C to address (I/O port) 
12F8 (assume address 12F$8 is an output port): 


1 Type 012F8,3C (RETURN). 


DEBUG displays: 


-012F8,3C 
0000:12F8 3C 
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Q (QUIT) 
PURPOSE Terminates the DEBUG program. 
SYNTAX Q 


The Quit command terminates the DEBUG program without 
saving the file you are working on. Control is returned to MS-DOS 
command mode. 


COMMENTS None. 


DEBUG Program 


EXAMPLE 


To save the file myprog on disk and quit the 
DEBUG program: 


1 Type Nmyprog (RETURN). 
DEBUG displays: 


-Nmyprog 


2 Type W @eruan). 


The file myprog is saved on disk. DEBUG 
then displays: 


-Nmyprog 
-W 


3 Type Qh 


The DEBUG program is terminated and 
displays. 


-Nmyprog 
-W 
-Q 


> 
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Le 


PURPOSE 


SYNTAX 


name 
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R (REGISTER) 


Displays the contents of the registers and flag 
settings, with the option to change the values. 


Riname]F] 


Any valid register name whose values are to be 
examined and/or optionally changed. Valid 
register names for the 8086 microprocessor are: 


AX DX SI ES IP 
BX SP DI SS PC 
CX BP DS CS 


Note: IP and PC both refer to the 
Instruction Pointer. 


The flag settings are to be displayed and 
optionally changed. The flags and their values 
are: 


Flag Set Clear 
Overflow OV (yes) NV (no) 


Direction DN (decrement) UP (increment) 
Interrupt EL (enabled) DI (disabled) 


Sign NG (negative) PL (plus) 
Zero ZR (yes) NZ (no) 
Auxiliary AC (yes) NA (no) 
Carry 

Parity PE (even) PO (odd) 
Carry CY (yes) NC (no) 


DEBUG Program 


COMMENTS 


© If you specify R without parameters, then the values of all 
registers are displayed along with the flag settings and the 
next instruction to be executed. For Example: 


-R 

AX=058D BD=0000 CS=0000 Dx=0000 

SP=FFFO BP=0000 ST=0000 DI=0000 DS=058D 
ES=058D CS=058D IP=013B 

NV UP EI PL NZ NA PO NC 

058D:013B 083D8 MOV DS,AX 


@ If you specify R with a register name, then DEBUG displays 
the values of that register. The command then waits for you 
to do one of the following: 


1 Press (RETURN) to terminate the Register command without 
changing the value of the displayed register. 


2, Change the value of the register by entering the two-digit 
hexadecimal value, then terminate the Register command 
by entering (RETURN). 
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© If you specify RF, then the current flag settings are displayed. 
You then do one of the following: 


1 


2 


D-48 


Press to terminate the Register command without 
changing the flag values, 


Change the setting of one or more flags by entering the 
alternate value of the appropriate flags. The new values 
may be entered in any order, with or without delimiters. 


DEBUG Program 


EXAMPLE 1 To display all registers and flags without 
changing any values: 


1 Type R (RETURN). 
DEBUG displays: 


-R 

AX=058D BD=0000 CS=0000 Dx=0000 

SP=FFFO BP=0000 SI=0000 DI=0000 DS=058D 
ES=058D CS=058D IP=013B 

NV UP EI PL NZ NA PO NC 

058D:013B 083D8 MOV DS,AX 


2 Type (RETURN). 


This terminates the command without 
changing values. DEBUG then displays: 


-R 

AX=058D BD=0000 CS=0000 Dx=0000 

SP=FFFO BP=0000 SI=0000 DI=0000 DS=058D 
ES=058D CS=058D IP=013B 

NV UP EI PL NZ NA PO NC 

058D:013B 083D8 MOV DS , AX 
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EXAMPLE 2 To display and change the SP register to 0000: 


1 Type RSP (RETURN). 


DEBUG displays: 


-RSP 
SP FFFO 


2 Type 0000 GETURN. 


The value of the SP register, which was 
FFF, is changed to 0000. DEBUG then 
displays: 


-RSP 
SP FFFO 
-0000 


EXAMPLE 3 To display the flag settings only: 


1. Type RF (Return). 
DEBUG displays: 


-RF 
NV UP EI PL NZ NA PO NC 
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S (SEARCH) 
PURPOSE Searches a range of addresses for a specified 
value(s). 
SYNTAX S<range>,value[,value+1,value+2....] 
range The range of addresses within which the search 


is to be made. If you only enter the offset, the 
segment indicated by the DS register is 
assumed. 


value The value to be searched for. When searching 
for more than one value at a time, the values 
must appear in memory in the same order to be 
a correct match. In this case, the DEBUG 
program indicates the address of the first value 
in the pattern. 


For each occurrence of the value(s) within the specified range, 
DEBUG returns the address of the first value. 


COMMENTS If no address is returned, no match was found. 


DEBUG Program 


EXAMPLE To search 256 addresses starting at 0400, for 
the value 2A: 


1. Type S0400L100,2A (ReTuRN). 


DEBUG displays: 


-S0400L100, 2A 
058D:0408 


058D:04CA 


The display indicates that addresses 0408, 
042C, and 04CA in the range 0400 through 


0500 contain the value 2A. 
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T (TRACE) 


PURPOSE Executes one or more instructions and displays 
the register values, flag settings and the next 
instruction to be executed. 


SYNTAX T[=address],value] 

address The starting address of partial execution. 
value The number of instructions to be executed. 
COMMENTS 


@ Ifthe =address parameter is not specified, execution begins at 


CS:IP. 


@ If the value parameter is not specified, only one instruction is 
executed. 


@ The registers and flags are displayed in the same format as 
that of the R (Register) command (without parameters). 
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EXAMPLE To execute four consecutive instructions in 
memory starting at address 0200: 


1 


Type T=0200,4 (RETURN). 


DEBUG executes the instructions 
associated with addresses 0200 through 
0203 and displays: 


-T=0200,4 

AX=058D BD=0000 CS=0000 Dx=0000 
SP=FFFO BP=0000 SI=0000 DI=0000 
DS=058D 

ES=058D CS=058D IP=013B 

NV UP EI PL NZ NA PO NC 
058D:013B 083D8 MOV DS,AX 
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U (UNASSEMBLE) 


-oo 


PURPOSE 


SYNTAX 


range 


address 


COMMENTS 


Disassembles strings of values in memory and 
displays them as assembler-like statements 
along with their corresponding addresses. 


Uj[range] 
or 
U[address] 


The range of addresses whose values are to be 
disassembled. If you do not specify the 
segment, then the segment indicated by the CS 
register is assumed. 


The address of the value which is to be 
disassembled. If you do not specify the 
segment, then the segment indicated by the CS 
register is assumed. 


@ If you specify U without parameters, then 32 addresses are 
disassembled starting at the address specified by the CS:IP 


register. 


@ The number of addresses disassembled may be slightly more 
than the number you specified. This is because instructions 
are not always the same length and the final address in a 
range will not always contain the last address of an 


instruction. 
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@ The first address of a range, or the address parameter, must 
refer to the first address of an 8086 microprocessor instruction, 
otherwise results are unpredictable. 


EXAMPLE To disassemble instruction in addresses 
0204 through 020B: 


1 Type U0204L8 


DEBUG displays: 


-U0204LB 

058D:0204 
058D:0208 
058D:0209 
058D:020B 


8D16DFOD 
42 INC 
03D0 ADD 
8916E50B 


(RETURN). 


LEA DX[ODDF] 
Dx 

DX, AX 

MOV [OBES] ,Dx 


The display indicates what instructions 
are located in addresses 0204 through 


020E. 
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W (WRITE) 


PURPOSE 


SYNTAX 


address 


drive 


block 


value 


COMMENTS 


Writes a file or absolute disk blocks to disk 
from memory. 


W(address],drive,block,value] 


The start address of the code in memory that is 
to be written to disk. If you enter only an 
offset, then the segment indicated in the CS 
register is assumed. 


The drive containing the specified blocks to 
which code in memory is to be written. For 
drive A you must enter 0, for drive B you must 
enter 1, for drive C you must enter 2, and so on. 


The block number on disk that is the first of a 
contiguous range of blocks to be overwritten 
with code from memory. 


The number of disk blocks to be overwritten 
with code from memory. 


© If you specify the command without parameters, then the file 
is written to disk starting from memory address CS:100. If you 
specify the address parameter, then the file in memory, 
starting from the specified address, is written to disk. 


DEBUG Program 
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Before executing the command, BX:CX must be set to the 
number of addresses to be written. This value was set up 
correctly when the file was loaded (either by the L (Load) 
command or the DEBUG command itself). However, if, since 
loading the file, you have executed a G (Go) or T (Trace) 
command, then the value of BX:CX have been changed. Be 
sure this value is set up correctly. 


When the command writes a file to disk, it obtains the drive 
specifier and filename via the file control block set up at 
CS:5C. If no drive specifier is set up, then the default is 
assumed. This file control block is set up either by the 
DEBUG command (for the file you specify as a parameter to 
DEBUG) or by subsequent N (Name) command. 


If it does not indicate the file specifier you require, you must 
set up this file control block using the N (Name) command. 
Refer to" Memory Maps, Control Blocks, and Diskette 
Allocation" for further details. 


When the file is written to disk it overwrites the version 
currently on disk unless the specified filename does not exist, 
in which case a new file is created. 


If all parameters are specified, then the code in memory is 
written to the drive specified by the parameter. The data to be 
written starts at the memory location specified by the address 
parameter, and is written to the blocks on the disk specified by 
the block and value parameters. Be extremely careful to 
correctly specify the value, since information stored there 
previously will be destroyed by this operation. 
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EXAMPLE To write the file myprog to disk starting from 
location 0200: 


1 Type Nmyprog (RETURN). 
DEBUG displays: 


-Nmyprog 


The N (Name) command identifies the 
filename for the write command. 


2 Type W0200 (ReTurN). 


The file myprog is written to disk from 
memory starting at address 0200. DEBUG 
then displays: 


-Nmyprog 
-W0200 
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DEBUG Error Messages 


BF Bad Flag 
You attempted to alter a flag, but entered 
some characters that are not acceptable pairs 
of flag values. See R (Register) command for 
the list of acceptable flag entries. 


BP Too many Breakpoints 
You specified more than ten breakpoints as 
parameters to the GO command. Reenter the 
command with ten or fewer breakpoints. 


BR Bad Register 
You entered the R command with an invalid 
register name. 


DF Double Flag 
You entered two values for one flag. 


CONFIG.SYS 


a eT 


E-1 


CONFIG.SYS 


Overview 


CONFIG.SYS is a special file that MS-DOS uses to modify system 
parameters. Every time you start your system, MS-DOS searches 
for CONFIG.SYS in the ROOT directory on the default drive. If 
MS-DOS finds CONFIG.SYS, it executes the commands it finds 
there. 


Some applications programs require you to make modifications to 
CONFIG.SYS. If you have purchased special hardware, a “device 
driver” may need to be identified in CONFIG.SYS. 
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CONFIG.SYS Commands 


ee 


The special file CONFIG.SYS is processed automatically when 
MS-DOS starts. As with the batch file AUTOEXEC.BAT, this 
processing is automatic. MS-DOS will simply look at the root 
directory to see if the file is there. 


CONFIG.SYS is an ASCII text file that can be edited by EDLIN or 
any other text editor that produces ASCII files. Five commands 
can be used in the CONFIG.SYS file. Each command changes a 
system parameter. 


COMMANDS 


BREAK <ON!OFF> 
Changes the way MS-DOS checks for a CTRL/BREAK 


BUFFERS=xx 
Sets the number of data buffers that MS-DOS uses. 


DEVICE=(d:) (path) filename 
Adds a nonstandard device driver to MS-DOS. 


FILES=xx 
Sets the number of files that can be simultaneously open. 


SHELL=(d:) (path) <filename> (d:) <path> /P 
Specifies an alternate command processor. 
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Break 


Buffers 


Normally, MS-ODS checks for a CTRL/BREAK 
only when it is doing input or output. Some 
programs do very little (if any) input or output 
for long periods of time. The BREAK ON 
command sets MS-DOS to check for a 
CTRL/BREAK when any MS-DOS function is 
called. 


BREAK OFF resets the default so that MS- 
DOS only checks for a CTRL/BREAK during 
input and output. This command can be used 
to override a BREAK ON that was set by 
CONFIG.SYS. 


The number of buffers has an effect on both 
the speed of disk I/O and available memory. A 
larger number of buffers allocates more 
memory to the system for operations. This is 
highly desirable for systems with large 
amounts of RAM that will be used for database 
applications. It is highly undesirable for 
systems with minimal RAM to do little work 
with disk files. 
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The system default is BUFFERS=10, which is 
adequate for most purposes and requires 5K of 
RAM. If your system will be doing a 
significant amount of data handling, especially 
on a fixed disk, increasing BUFFERS would 
improve access times at a cost of only 512 bytes 
of internal memory for each additional buffer. 


When MS-DOS is first started, it loads all of 
the standard device drivers for the keyboard, 
screen and so on. If your system requires a 
special device driver, this command tells MS- 
DOS where to find it. The device driver will 
then be loaded as an extension to MS-DOS. 


Device drivers are .COM files with a specific 
structure described in Chapter 9 in the System 
Programmer’s Guide. The command DEVICE 
= ANSILSYS causes MS-DOS to replace the 
standard display and keyboard device drivers 
with the extended screen and keyboard support 
that the extended functions require. 


If you wish to load several special device 
drivers, you must use a DEVICE command for 
each one. 


Opening a file with an ASCIIZ string 
eliminates the traditional direct handling of a 
File Control Block (FCB). MS-DOS will handle 
all these things for you by creating and 
maintaining FCBs internally. To do this, it 
needs memory. Each file requires 39 bytes of 
memory. 
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Shell 


The FILES command sets aside memory for 
this operation. The default is FILES = 12. The 
maximum is FILES = 99. This is the limit for 
the entire system. A particular process (or 
program) can still have only 20 files open at 
once. 


The COMMAND.COM file that MS-DOS uses as 
its “front end” processor can be replaced by 
another command processor. The SHELL 
command specifies the file to be used and the 
default path for processing commands. The 
command processor must be able to read and 
execute commands, and handle interrupts 22H, 
23H, and 24H. 


Since COMMAND.COM handles internal 
commands, .BAT file execution, and .EXE file 
loading, these functions will be unavailable 
unless the new command processor duplicates 
them. 
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EXE2BIN 


Program Structure and Loading 


SYNTAX 


EXAMPLE 


DISCUSSION 


EXE2BIN <input filename> <output file 
name> 


Both file names are in the form: 
(d:[path}filename 
EXE2BIN B:PROG.EXE B:PROG.COM 


In specifying the input file, everything except 
the filename is optional. If you do not specify a 
drive, the default is used. If you do not specify 
a path, the default path is used. If you do not 
specify an extension, the default is EXE. The 
input file is converted to .COM file format 
(memory image of the program) and placed in 
the output file. 


You are not required to enter any part of the 
output file specification. If you do not specify a 
drive, the drive of the input file will be used. If 
you do not specify an output path or filename, 
the input path or filename will be used. If you 
do not specify a filename extension in the 
output filename, the new file will be given an 
extension of .BIN. 


The input file must be in valid .EXE format 
produced by the linker. The resident, or actual 
code and data part of the file must be less than 
64K. There must be no STACK segment. 
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Two kinds of conversion are possible, depending 
on the initial CS:IP (Code Segment: 
Instruction Pointer) specified in the .EXE file: 


1 If CSIP is specified as 0000:100H, it is 
assumed that the file is to be run as a 
.COM file with the location pointer set at 
100H by the assembler statement ORG; the 
first 100H bytes of the file are deleted. No 
segment address fixups (that is, 
instructions that contain a reference to an 
absolute segment address) are allowed, as 
-COM files must be segment relocatable. 


Once the conversion is complete, rename 
the resulting file with a .COM extension. 


The command processor can load and 
execute the program in the same way as 
the .COM programs supplied on your 
MS-DOS System diskettes. 


2 If CS:IP is not specified in the .EXE file, a 
pure binary conversion is assumed. If 
segment fixups are necessary (i.e., the 
program contains instructions requiring a 
segment address), you are prompted for the 
fixup value. This value is the absolute 
segment at which the program is to be 
loaded. 


The resulting program is usable only when 
loaded at the absolute memory address 
specified by your application. 


EXE2BIN 


P-4 


The command processor is not capable of 
properly loading the program. This is the 
case when writing a .BIN program to use in 
an application such as a device driver that 
is always loaded at the same absolute 
address. 


EXE2BIN 


Messages 
es ee 


Amount read less than size in header 
The program portion of the file was smaller than indicated in the 
file’s header. You should reassemble and relink your program. 


File cannot be converted 

CS:IP does not meet of the criteria specified above, or it meets the 
-COM file criterion but has segment fixups. This message is also 
displayed if the file is not a valid executable file. 


File creation error 

EXE2BIN cannot create the output file. Run CHKDSK to 
determine if the directory is full or if some other condition caused 
the error. 


File not found 
The file is not on the diskette specified. 


Fixups needed — base segment (hex): 

The source (.EXE) file contained information indicating that a 
load segment is required for the file. Specify the absolute segment 
address at which the finished module is to be located. 


Insufficient disk space 
There is not enough disk space to create a new file. 


Insufficient memory 
There is not enough memory to run EXE2BIN. 


WARNING — Read error in EXE file 

Amount read less than size in header. This is a warning message 
only. However, it is usually a good idea to reassembly and relink 
your source program when this message appears. 
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ANSLSYS 


Description 


An ANSI Escape Sequence is a series of characters, beginning with 
an ESCAPE character, that you can use to define functions to 
MS-DOS. You can reassign keys, change graphics functions, and 
affect cursor movement. 


There are a variety of applications for the extended keyboard and 


screen support afforded by the ANSI Escape Sequences. Some of 
the most common uses are: 


@ You may be engaged in communications with a host computer 
that expects ANSI Escape Sequences (i.e., your AT&T PC is 
emulating a terminal). 


@ You may reassign a function key so that, for example, pressing 
F9 clears the screen. 


@ Some applications software that you purchase may make use of 
these sequences. 


Installing the ANSI.SYS Device Driver 


To utilize the ANSI Escape Sequences, load the special device 
driver, ANSI.SYS, by placing a command in the CONFIG.SYS file. 


Put this statement in CONFIG.SYS: 
DEVICE=ANSI.SYS 


Every time you start the MS-DOS, the ANSLSYS driver will be 
loaded into memory so that you can use the escape sequences. 


ANSILSYS 


Note: In the following syntax diagrams, replace the 
number sign (#) with the appropriate ASCII digits. 


If you do not specify a value, or specify a value of zero, the default 
will be used. 


In the control sequences below, ESC is the 1-byte code for ESC 
(hex 1B). 


Cursor Position (CP) 


Syntax ESC(#;#H 
Moves the cursor to the position specified 
by the parameters. The first parameter 
specifies the line number and the second 
parameter specifies the column number. 
The default value is one. If no parameter 
is given, the cursor moves to the home 
position. 


Cursor Up (CU) 


Syntax ESC[#A 
Moves the cursor up one line without 
changing columns. The value of # 
determines the number of lines moved. 
The default for # is one. This sequence is 
ignored if the cursor is already at the top 
line. 
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Cursor Down (CD) 


Syntax ESC[#B 
Moves the cursor down one line without 
changing columns. The value of # 
determines the number of lines moved. 
The default value for # is one. This 
sequence is ignored if the cursor is already 
at the bottom line. 


Cursor Forward (CF) 


Syntax ESC[#C 
Moves the cursor forward one column 
without changing lines. The value of # 
determines the number of columns the 
cursor will move. The default value for # is 
one. This sequence is ignored if the cursor 
is already in the rightmost column. 


Cursor Backward (CB) 


Syntax ESC[#D 
Moves the cursor back one column without 
changing lines. The value of # determines 
the number of columns the cursor will 
move. The default value of # is one. The 
sequence is ignored if the cursor is already 
in the leftmost column. 


ANSLSYS 


Horizontal and Vertical Position (HVP) 


Syntax 


ESC|##f 

Moves the cursor to the position specified 
by the parameters. The first parameter 
specifies the line number and the second 
parameter specifies the column number. 
The default is one. If no parameter is 
given, the cursor is moved to the home 
position. 


Device Status Report (DSR) 


Syntax 


ESC(6n 

The console driver puts a CPR (Cursor 
Position Report) sequence upon receipt of 
DSR. See below. 


Cursor Position Report (CPR) 


Syntax 


ESC(#;#R 

The CPR sequence reports the current 
cursor position through the standard input 
device. The first parameter specifies the 
current line; the second parameter specifies 
the current column. 
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Save Cursor Position (SCP) 


Syntax 


ESC{s 

The current cursor position is saved. This 
cursor position can be restored with the 
RCP (Restore Cursor Position) sequence. 


Restore Cursor Position (RCP) 


Syntax 


ESCju 

Restores the cursor of the value it had 
when the console driver received the SCP 
(Save Cursor Position) sequence. 


Erase in Display (ED) 


Syntax 


Erase in Line (EL) 


Syntax 


ESC[25 
Erase the entire screen. Cursor moves to 
the home position. 


ESC{k 
Erases from the cursor to the end of the 
line and includes the cursor position. 


Set Graphics Rendition (SGR) 


Syntax 


ESC(#;..5#m 
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Sets the character attribute specified by 
the parameter(s). All characters that 
follow will have the attribute specified 
until the next occurrence of this sequence. 


Parameter 
0 


Meaning 

All attributes Off (white on 
black) 

Bold On (high intensity) 
Underscore On (mono display 
only) 

Blink On 

Reverse Video On 
Canceled On (invisible) 
Black foreground 

Red foreground 

Green foreground 
Yellow foreground 

Blue foreground 
Magenta foreground 
Cyan foreground 

White foreground 

Black background 

Red background 

Green background 
Yellow background 
Blue background 
Magenta background 
Cyan background 

White background 
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Set Mode (SM) 


G-8 


Syntax 1 


Syntax 2 


Syntax 3 


Syntax 4 


ESC[=#h 


ESC[=h 


ESC[=Oh 


ESC|(?7h 
Invokes the screen width or type 
corresponding to the parameter. 


Parameter Meaning 

40X25 black and white 
40X25 color 

8025 black and white 
80X25 color 

320X200 color 

320X200 black and white 
640X200 black and white 
wrap at end of line 
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Reset Mode (RM) 


Syntax 1 ESC[=41 
Syntax 2 ESC[=I 

Syntax 3 ESC[=O1 
Syntax 4 ESC((?71 


Parameters are the same as for Set Mode 
(SM) except that parameter 7 resets wrap 
to end-of-line mode (characters past the 
end of line are thrown away). 
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Keyboard Key Reassignment (KKR) 


Syntax 1 ESC|#;#;...#D 
Syntax 2 ESC|“string”;p 
Syntax 3 ESC|#;“string”;##;“string’s4p 


The first ASCII code in the control 
sequence defines which key is being 
mapped. The remaining numbers define 
the sequence of ASCII codes generated 
when this key is intercepted. However, if 
the first code in the sequence is zero 
(NUL), then the first and second codes 
make up an extended ASCII redefinition. 
(See the chapter on “ROM BIOS Service 
Routines” in the “System Programmer's 
Guide” for more information.) 


EXAMPLES 


@ Reassign the F9 key to do a CLS 
command followed by a carriage 
return. 


ESC[0;67;‘‘CLS’’;13p 
@ Map a lowercase e to upper case. 


ESC[101;69p 
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RAMDISK 


Overview 


RAMDISK is a device driver that lets you use memory as if it were 
disk. This improves your system’s performance. 


You can see an especially big improvement in performance by 
loading assemblers and compilers into RAMDISK. 


The RAMDISK.DEYV file is a device driver that simulates a disk 
drive by using a portion of your system’s memory. 


The RAMDISK operates at the system’s memory speed. 


You can install more than one RAMDISK. The drive letters are 
automatically assigned. For example, if your system has one 
floppy diskette drive and one fixed disk drive, the floppy drive is 
referred to as A and the fixed disk as C. The first RAMDISK is 
referred to as D, the second as E, and so on. 


You can specify the amount of system memory that is to be used 
by the RAMDISK. The default size is 8K. 


Note: The contents of the RAMDISK are lost when you 
restart the system or turn off the system’s power. Use the 
COPY command to move files from RAMDISK to an actual 
disk if there are files you want to save. 
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Installing the RAMDISK 


To install the RAMDISK device driver, include the following 
statement in the CONFIG.SYS file: 


device=(d:[pathname]ramdisk.dev[nnn] 


nnn is the size of virtual RAMDISK in K bytes (1024). The default 
value is 8K bytes. 
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The following terms are used in this guide. 


a 
This abbreviation means " all files on the disk." The command " copy a:*.* b:" 
means " copy all files from the disk in drive A to the disk in drive B." 


Abort 
This is a response you can give to MS-DOS when you see a device error message 
displayed." Abort” means stop the program command currently executing.” Type 
"A" for Abort when you see" Abort, Retry, Ignore?" message. 


Application software 
Application software, also called software programs, consist of instructions to the 
computer which are written in a computer language. Application programs are 
usually distributed on floppy disks. 


Backup disk 
A backup disk is a backup of any disk you make with the BACKUP command. 


Byte 
A byte is a unit of measurement used by computers. A byte consists of eight " bits" 
(binary digits). In a binary numbering system, only two marks are used: 0 and 1. 
Each of these marks is called a binary digit, or a bit. When you type a Dir 
command, MS-DOS displays filenames and the size of the files. For example, the 
size of " myfile.txt" may be 6900, which stands for 6900 bytes. 


Command 

A command is really a short program that tells MS-DOS how to do a specific task. 
An example of a command is " Dir", which tells MS-DOS to display a directory 
listing (the contents of a disk). Some commands are" internal" to MS-DOS; that is, 
they are not displayed when you display the directory. Other commands, such as 
Format and Diskcopy, reside on the disk as programs with .EXE extensions. The 
format program is named FORMAT.EXE, for example. 


Control key — 

(Gia A control key, usually abbreviated " Ctrl," is a key that allows you to give 
MS-DOS special commands such as" stop the last command" and" stop the display 
from scrolling.” To use the control key, press the (Gia) key down at the same time 
as you press another key. Common control key sequences are JC (end a 
command before it is finished) and (@aQS (stop the screen display). 
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is also 


This is a control sequence that stops a command while it is running. 
used to exit EDLIN insert mode. 


Gas 
This is a control sequence that stops the screen display from scrolling. See also 
Control key. 


Copy 
This is an MS-DOS command. It copies one or more files from one disk to another, 
or on the same disk. 


Default disk drive 
‘The default disk drive is the drive that MS-DOS searches for any filenames you 
may type. MS-DOS will look for files in the default drive unless you specify a 
different default drive. The default drive letter is always displayed with the 
MS- DOS prompt. For example, if the prompt is A>," A" is the default drive. 


Del 
Del is a command that you give to MS-DOS. It is short for " Delete" and tells 
MS- DOS to delete one or more files. A synonym for Del is " Erase." 


Device errors 
Device errors are errors that MS-DOS displays while reading or writing to devices 
on your computer. Devices can be printers, disk drives, and the screen display. 


Dir 

Dir is a command that you give to MS-DOS. It is short for " Directory." When you 
type "dir", MS-DOS will display the contents of the disk on the default drive. The 
command "dir b:" displays the contents of the disk in drive B. 


Directory 

A directory is a table of contents for a floppy disk. The directory contains the 
names of your files, and also has information on the size of the files and the dates 
they were created or last modified. 


Disk 
See Floppy disk and Fixed disk. 


Diskcopy 
Diskcopy is an MS-DOS command used to copy diskettes. 
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Disk drive 

A disk drive is a piece of hardware that is attached to your computer. A disk drive 
can be either a floppy or a fixed drive. You insert floppy disks into floppy disk 
drives; fixed disk drives are built into the computer. A fixed disk can hold more 
information than a floppy disk. 


Disk drives are commonly referred to as the" A" drive and the" B" drive. Fixed 
disks are usually the" C" drive. Your computer manual should tell you which drive 
is labeled drive A and which drive is drive B. If you have only one disk drive, that is 
drive A. 


Disk operating system 

A disk operating system is a group of programs that act as a translator between 
you and your computer. A disk operating system is usually distributed on floppy 
disks, although you can copy the programs to a fixed disk if you have one. 


Drive name 
A drive name consists of a drive letter and a colon. A drive name tells MS-DOS 
what drive to look on for the file. For example, the filename " a:myfile.txt" contains 
a drive name (a:) that tells MS-DOS to look on drive A for the file named 

" myfile.txt.” 


Editor 

An editor is a program that allows you to type text and data on the computer. All 
editors allow you to move, add and delete characters and lines, and save files. The 
MS-DOS editor is called EDLIN. This is a line-oriented editor, which means that 
you “an only process text one line at a time. Other types of editors are called 
screen-oriented editors. These allow you to operate on large portions of text (even 
the entire file) at a time. Generally speaking, word processing programs are 
powerful, screen-oriented editors. 


EDLIN 
EDLIN is a line-oriented editor that comes with MS-DOS. See also Editor. 


Enter key — or 
The Enter key is marked" Return" on some computers. This key is usually pressed 
after entering data or text. it is also pressed after you have typed a command to 


MS-DOS. 


Erase 
Erase is a synonym for the MS-DOS Del command. See also Del. 
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Error messages 

Error messages are displayed on the screen if MS-DOS detects that something went 
wrong when it tried to process a command or program. Refer to Appendix A, 

" Messages," for the appropriate response to each error message. 


Extension 
A file extension is from 1-3 characters long and starts with a period. Extensions are 
often used to identify files: most application programs supply their own extensions 
to files they create. All BASIC files use an extension of " BAS." See also Filename. 


File 

A file is a collection of related information. A file on a disk can be compared to a 
file folder in a desk drawer. For example, a file folder might contain the names and 
addresses of your friends. You might name this file" Friends." A file on a disk 
could also contain the names and addresses of friends. This file could also be named 
"friends." Programs are also files. 


Filename 

There are certain rules for naming files on a disk. Names can be from 1-8 
characters long, and they can have a file extension. An extension is from 1-3 
characters long and starts with a period (.). Together, the file name and extension 
are referred to as filename. An example of a filename is " myfile.txt" . Certain 
filenames are reserved by MS-DOS and should not be used when naming your files. 


These filenames are: 


aux 
con 
Ist 

prn 
nul 


Fixed disk 
A fixed disk is a disk that is built into the computer. A fixed disk can store much 
more information than a floppy disk, and the computer can retrieve information 


from it faster. See also Floppy disk. 
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Floppy disk 

A floppy disk is a plastic square that consists of a disk (inside) sealed into a 
protective cover (outside). There is often a write-enable notch on the right side of 
the disk. A floppy disk is used for storing programs and files. Disks can be either 
"single-sided" or " double-sided." Single-sided disks store files on only one side of 
the disk; double-sided disks store information on both sides of the disk. 


When you insert a floppy disk in the computer, the disk drive reads the magnetic 
surface of the disk. This is how information is passed from a disk into the 
computer's memory. See also Write-protect notch, Memory. 


Format 

Format is an MS-DOS command that formats blank disks. You must format every 
disk before it can be used with MS-DOS. Formatting a disk changes it to a format 
that MS-DOS can use. It also analyzes the disk for defective spots. 


GWBASIC 

GWBASIC stands for Beginner's All-purpose Symbolic Instruction Code. 
GWBASIC is a general-purpose computer language and is the first computer 
language that many people learn. 


Ignore 
This is a response to a device error message. It tells the computer to ignore the 
error and continue processing. Note that this response can damage data on the disk. 
Type" I" for Ignore when you see the" Abort, Retry, Ignore?” message. 


Input 

Input is information given to the computer. This information can come from the 
keyboard (when you type commands), programs, and even other computers. See also 
Output. 


Memory 

Memory is synonymous with " computer storage." Most programs come on a floppy 
or fixed disk. They are then transferred into the computer's memory (internal 
storage) when you run the program. When the program is finished, it is transferred 
back to the disk. Since a computer's memory is limited, this is an efficient way to 
run many different programs. 


Memory is measured in kilobytes (see also byte). Computers that run MS-DOS 
commonly have 128K of memory or more. 
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Monitor 
A monitor looks a lot like a television screen. It attaches to your computer (or may 
come already attached) so that you can communicate with MS-DOS. 


MS-DOS master disk 
MS-DOS is distributed on one or more floppy disks (called " master disks" ) along 
with the user's manuals. You should always make a working copy of the master 


disk or disks before you start using MS-DOS on a routine basis. See also Backup 
disk. 


Operating system 

An operating system is a group of programs that provides the interface between 
you (the user) and the hardware (your computer). An operating system translates 
your commands to the computer so that you can perform tasks such as creating 
files, running programs, and printing documents. 


Output 

Output is information that is transferred from the computer to any " output 
device." Output devices are printers, disk drives, and the screen (monitor). An error 
message, for example, is output. 


Print 
This is an MS-DOS command that is used to Spool print files to your computer's 
printer. 


Printer 
A printer is a device that is attached to your computer. It allows you to print files 
so that you have a" hard copy" (paper copy or printout) of the information to store. 


Program 

A program is a complete set of instructions, written in computer language, that 
tells the computer exactly how to handle a problem. Some commands in MS-DOS, 
like Diskcopy, are actually small programs. Programs are stored as files on a disk, 
and usually have special filename extensions to identify them as programs. A 
common program file extension is".COM" (for " command” ) or " .EXE" (for 
executable" ). 


Prompt 
The MS-DOS prompt consists of the default drive letter (usually A, B, or C) and a 
greater-than sign. An example of the MS-DOS prompt is B>. 
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This is an MS-DOS command. It is used to rename files. The abbreviation " Ren" 
can be used in place of the full command name. 


Retry 
This is a response you can give to MS-DOS in response to" Abort, Retry, Ignore?" 
following a device error message. Retry means" retry the last command.” Usually, 
you will choose Retry only after you have performed a corrective action (such as 
closing the disk drive door or inserting the proper disk in the drive). Type" R" for 
Retry when you see the" Abort, Retry, Ignore" message. 


Return key — or GH) 
The Return key is marked " Enter" on some computers. This key is usually pressed 
after entering data or text. It is also pressed after you have typed a command to 
MS-DOS. 


Software 

Software is the internal programs or routines written by programmers to simplify 
programming and computer operations. These routines allow the programmer to use 
his own language (English) or mathematics (Algebra) to communicate with the 
computer. Some examples of software are: operating systems, word processing 
programs, and spreadsheet programs. Software is also called programs. 


Type 
This is an MS-DOS command used to display files on the screen. 


Word processing 
Word processing generally involves using an editor and a text processing program 
to manipulate text and data in files. (Some word processing programs include both 
functions.) Word processing allows you to type text and then reformat it--for 
example, into columns or double-spaced lines. See also Editor. 


Write-enable notch 

Some floppy disks are protected; that is, you can examine information on the disk 
but you cannot change it. These disks are called " write-protected" disks. They 
usually have a small tab (a " write-protect tab" ) covering a notch on the right side 
of the disk. You can copy information onto the disk by removing the tab first. If the 
disk does not have a write-enable notch, you cannot change the information on the 
disk. 


Write-protect tab : 
The small tab that covers the write-enable notch on the disk. See also Write-enable 


notch. 
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